NumericSpinner

Gets or sets the style of the text box that shows and edits the value.

The spinner sets the text box's background, foreground, padding and borders itself, from its own Control.Background, Control.Foreground and Control.Padding. Use the style for the rest – to align numbers to the right, for example.

<spin:NumericSpinner.ContentHostControlStyle>
    <Style TargetType="TextBox">
        <Setter Property="HorizontalContentAlignment" Value="Right" />
        <Setter Property="VerticalContentAlignment" Value="Center" />
    </Style>
</spin:NumericSpinner.ContentHostControlStyle>

Gets or sets how much each step adds to or takes from the value.

A step from an empty box starts from 0, or from the nearer limit when 0 is outside the range. A step that would pass a limit stops at the limit. Use a fraction such as 0.25 for fine steps, and a ValueFormat that shows enough decimal places.

Gets or sets whether the user is prevented from changing the value, while still being able to see, select and copy it.

While it is on, typing, the arrow buttons, the arrow and Page keys, Ctrl+Home, Ctrl+End and the mouse wheel all leave the value alone. The value can still be set from code or a binding.

Gets or sets the largest value the spinner allows.

A value above it, typed, stepped or set from code, becomes the maximum. Changing the range re-checks Value at once.

Gets or sets the smallest value the spinner allows.

A value below it, typed, stepped or set from code, becomes the minimum. Changing the range re-checks Value at once; the value that was asked for is remembered, so widening the range again restores it.

The minus sign can be typed only while the minimum is below zero. If the minimum is set above MaximumValue, the minimum wins.

Gets or sets the style of the two buttons that step the value up and down.

The buttons repeat while held down. A style of your own replaces the built-in one entirely, so set the width and template you want in it; the arrows inside are drawn by the spinner.

<spin:NumericSpinner.NavigationControlStyle>
    <Style TargetType="RepeatButton">
        <Setter Property="Width" Value="32" />
        <Setter Property="Padding" Value="8,5" />
        <Setter Property="Background" Value="#EEF2F7" />
    </Style>
</spin:NumericSpinner.NavigationControlStyle>

Gets or sets the colour of the up and down arrows on the spinner's buttons.

Under the pointer an arrow takes NavigationVisualOnMouseOverBrush instead.

Gets or sets the outline colour of an arrow on the spinner's buttons while the pointer is over that button.

Gets or sets the colour of an arrow on the spinner's buttons while the pointer is over that button.

When the pointer leaves, the arrow goes back to NavigationVisualFillBrush and NavigationVisualStroke.

Gets or sets the outline colour of the up and down arrows on the spinner's buttons.

Gets or sets the number in the spinner.

A value outside the range reads back as the nearer limit, and NaN as null. Every change raises ValueChanged and updates the box.

It does not bind two-way by default: write Mode=TwoWay to have the user's changes reach the source.

quantity.MinimumValue = 1;
quantity.MaximumValue = product.StockLevel;
quantity.Value = 1;

Gets or sets how the number is shown in the box, as a .NET numeric format string.

Use "0.00" for two decimal places, "N0" for whole numbers with thousands separators, "C" for currency or "0'%'" to append a percent sign without scaling. Only the display is rounded: Value keeps every digit, and tabbing through the box does not round it. An empty or null format is read as "0".

A format that adds text the spinner cannot read back – a currency symbol, say – makes the box show text the user cannot type; the user can still step the value, or clear the box and type a plain number.

<spin:NumericSpinner MinimumValue="0" MaximumValue="1000000" Increment="1000" ValueFormat="N0" />

Connects the text box and the two buttons in the template, and shows the current value.

A custom template provides a TextBox named PART_ContentTextBox and RepeatButtons named PART_IncreaseButton and PART_DecreaseButton, and may name the arrows inside them contentSurface_IncreaseVisual and contentSurface_DecreaseVisual (each a Polygon) to have them highlighted under the pointer.

Occurs when Value changes, whether the user typed or stepped it or code set it.

The event data is a ValueChangedEventArgs; cast the handler's argument to it to read the new value, or read Value. It is raised once the value has been held to the range, and not at all when a change leaves the value as it was – a step at a limit, say.

A bubbling routed event, so a parent element can handle it for several spinners.

Identifies the ContentHostControlStyle dependency property.

Identifies the Increment dependency property.

Identifies the IsReadOnly dependency property.

Identifies the MaximumValue dependency property.

Identifies the MinimumValue dependency property.

Identifies the NavigationControlStyle dependency property.

Identifies the NavigationVisualFillBrush dependency property.

Identifies the NavigationVisualOnMouseOverBorderBrush dependency property.

Identifies the NavigationVisualOnMouseOverBrush dependency property.

Identifies the NavigationVisualStroke dependency property.

Identifies the ValueChanged routed event.

Identifies the ValueFormat dependency property.

Identifies the Value dependency property.