syncfusion-wpf-domain-updown（同步融合 wpf 域 updown）

Implementing Syncfusion WPF DomainUpDown

Guide for implementing the Syncfusion® WPF DomainUpDown (SfDomainUpDown) control - a versatile input control that allows users to cycle through a predefined list of items using spin buttons (increment/decrement arrows).

When to Use This Skill

Use this skill when you need to:

• Implement a DomainUpDown control for item selection with spin buttons
• Populate predefined item lists that users can cycle through
• Customize spin button positioning (left, right, or both sides)
• Bind complex data objects with custom display templates
• Style and theme the control appearance
• Enable auto-reverse cycling from max to min values
• Handle mouse wheel and keyboard navigation gestures
• Create data-driven selectors with MVVM pattern support

Component Overview

The SfDomainUpDown control provides an elegant way for users to select values from a predefined list by clicking up/down buttons or using mouse wheel/keyboard navigation. Unlike numeric up-down controls, DomainUpDown works with any type of data - strings, objects, or custom types.

Key Capabilities:

• Data binding support with ItemsSource
• Custom content templates for complex objects
• Configurable spin button alignment (left, right, both)
• Smooth spin animations
• Auto-reverse cycling behavior
• Mouse wheel and keyboard gestures
• Extensive styling and theming options
• MVVM-friendly architecture

Assemblies Required:

• Syncfusion.SfInput.WPF
• Syncfusion.SfShared.WPF

Documentation and Navigation Guide

Getting Started

📄 Read: references/getting-started.md

When you need to:

• Install and set up the DomainUpDown control
• Add the control via designer or code
• Understand assembly dependencies
• Create your first basic implementation
• Configure the Value property
• Import necessary namespaces

Data Population and Binding

📄 Read: references/data-population.md

When you need to:

• Populate the control with a list of items
• Bind data using ItemsSource property
• Create data models and ViewModels
• Use ContentTemplate for custom display
• Display complex objects with multiple properties
• Implement MVVM data binding patterns

Spin Button Configuration

📄 Read: references/spin-button-alignment.md

When you need to:

• Customize spin button positioning
• Use SpinButtonsAlignment property
• Place buttons on the right (default)
• Place buttons on the left
• Split buttons on both sides (decrement left, increment right)
• Choose appropriate alignment for your UI

Appearance and Styling

📄 Read: references/appearance-styling.md

When you need to:

• Enable or disable spin animations
• Customize accent colors with AccentBrush
• Style up/down buttons with UpDownStyle
• Create custom control templates
• Modify borders, backgrounds, and foregrounds
• Apply fonts and layout customization
• Build comprehensive custom themes

Advanced Features

📄 Read: references/advanced-features.md

When you need to:

• Enable auto-reverse cycling behavior
• Handle mouse wheel scrolling
• Implement keyboard navigation
• Understand edge cases
• Optimize performance

→ See reference files for detailed examples and implementation patterns.