DomainSpinner

Creates a domain spinner with no items and nothing selected.

Set Items to give it its choices; the first one is then selected.

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:DomainSpinner.ContentHostControlStyle>
    <Style TargetType="TextBox">
        <Setter Property="HorizontalContentAlignment" Value="Right" />
        <Setter Property="VerticalContentAlignment" Value="Center" />
    </Style>
</spin:DomainSpinner.ContentHostControlStyle>

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 items the user steps through, in order.

Any list of reference-type objects will do – strings, or objects of your own whose ToString gives the text to show. A list of numbers or other value types is not an IEnumerable<object>; box them first, for example with numbers.Cast<object>().ToList().

Setting the property keeps the current value if the new list contains it, and otherwise selects the first item; an empty list clears the value. Items added to or removed from the same list afterwards are seen by the next step, but the selection is checked again only when the property is set again.

priority.Items = new List<object> { "Low", "Normal", "High", "Urgent" };
priority.Value = "Normal";

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:DomainSpinner.NavigationControlStyle>
    <Style TargetType="RepeatButton">
        <Setter Property="Width" Value="32" />
        <Setter Property="Padding" Value="8,5" />
        <Setter Property="Background" Value="#EEF2F7" />
    </Style>
</spin:DomainSpinner.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 position in Items of the item shown, or -1 when none is.

Setting it sets Value to the item at that position, and -1 clears the value. An index past the last item, or below -1, is ignored, and so is any index while Items is null.

A plain property, not a dependency property, so it cannot be the target of a binding; bind Value instead.

Gets or sets the item shown in the spinner.

Setting it selects the first item that equals it, or whose text is the same as its text, and SelectedIndex follows. A value that is not among the items is still shown, with SelectedIndex at -1; the next step then selects the first item.

Every change raises ValueChanged. It does not bind two-way by default: write Mode=TwoWay to have the user's choice reach the source.

Gets or sets whether stepping past the last item goes round to the first, and stepping back past the first goes round to the last.

Wrapping suits lists that are naturally circular, such as days of the week or compass points. Ctrl+Home and Ctrl+End go to the first and last item either way.

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

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 stepped or typed to another item or code set it.

The event data is a ValueChangedEventArgs; cast the handler's argument to it to read the new item, or read Value and SelectedIndex. It is raised as the user types too, each time completion moves to another item.

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

Identifies the ContentHostControlStyle dependency property.

Identifies the IsReadOnly dependency property.

Identifies the Items 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 Value dependency property.

Identifies the Wrap dependency property.