Dirkster.NumericUpDownLib 2.3.1

Overview

This library implements numeric up down WPF controls to edit a value:

• by dragging the mouse vertically/horizontally (see recording below) or
• by clicking up/down arrow (repeat) buttons or
• up/down or left right cursor keys or
• spinning mousewheel up down on mouseover or
• editing a textbox

The initial values are: MinValue = 0, Value = 0, MaxValue = 0
Each control maintains the condition: MinValue <= Value <= MaxValue at all times. This means, if you want to setup a Min/Max value range you have to be careful to do this in the right order:

• Positive Range: MaxValue = 12, Value = 1, MinValue = 1
  → Value is editable in the range of 1 and 12: [1, 12].

• Negative Range: MinValue = -12, Value = -1, MinValue = -1
  → Value is editable in the range of -1 and -12: [-1, -12].

and so forth... see also Issue #4 for more details.

Each control implementation is specific for a certain .Net data type:

Percentages can be edit at [0-100] while backend viewmodels handles [0-1] values, see FactorToDoubleConverter and PercentageUpDownDemo in demo clients at project site.

Controls are fully themeable. Project site contains demos for:

• Dark/Light theme and
• Generics theme test clients.

More Features:

• Small Increments and Decrements can be configured to be 1 or any greater value than 1.
• Large Small Increments and Decrements can be configured to be 10 or any other value greater 1.
• The width of the control can be configured to be fixed (textbox will scroll inside when text is too large)
• Up/Down button is disabled when min or max limit is already reached
• Up/Down button can be configured to be invisible
• Mouse drag mode for editing value can be enabled/disabled
• SelectAll on GotFocus of TextBox
• IsReadOnly property disables the textbox portion but leaves all other funtions for Increment/Decrement available

LargeStepSize and StepSize

There are mouse and keyboard input methods that support 2 different configurable increment/decrement values.

Mouse Drag Mode

The user can hover the mouse over the textbox portion of the control and:

• left click/drag vertically or
• left click/drag horizontally

to change the current value with the size configured in StepSize or LargeStepSize dependency property.

Mouse Wheel

The user can hover the mouse over the textbox portion and spin the mouse wheel with:

• no modifier key pressed or
• a modifier key pressed

to change the current value with the size configured in StepSize or LargeStepSize dependency property.

The modifier key for changing the value with LargeStepSize can be configured in the MouseWheelAccelaratorKey dependency property.

Cursor Keys

The user can click into the textbox portion of the control and:

• press cursor left or right or
• press cursor up and down

to change the current value with the size configured in StepSize or LargeStepSize dependency property.

Demo Applications

There is a demo application that shows the usage of the control (Light/Black themes enabled) and documents the features, such as, the ability to configure a minimum and maximum value that can be used to keep the resulting value within a given bound.

Theming

Load Light or Dark brush resources in you resource dictionary to take advantage of existing definitions.

    <ResourceDictionary.MergedDictionaries>
        <ResourceDictionary Source="/NumericUpDownLib;component/Themes/DarkBrushs.xaml" />
    </ResourceDictionary.MergedDictionaries>

    <ResourceDictionary.MergedDictionaries>
        <ResourceDictionary Source="/NumericUpDownLib;component/Themes/LightBrushs.xaml" />
    </ResourceDictionary.MergedDictionaries>

These definitions do not theme all controls used within this library. You should use a standard theming library, such as:

• MahApps.Metro,
• MLib, or
• MUI

to also theme standard elements, such as, button and textblock etc.

Visit the project's Wiki for mode details.