syncfusion-wpf-domain-updown

实现 Syncfusion WPF DomainUpDown

Syncfusion® WPF DomainUpDown（SfDomainUpDown）控件的实现指南——这是一种多功能输入控件，允许用户使用微调按钮（递增／递减箭头）循环浏览预定义的项目列表。

何时使用此技能

在以下情况下使用此技能：

• 实现 DomainUpDown 控件，以便通过微调按钮选择项目
• 填充预定义的项目列表，供用户循环浏览
• 自定义微调按钮的位置（左侧、右侧或两侧）
• 绑定复杂数据对象，并使用自定义显示模板
• 设置控件的样式和主题
• 启用自动反向循环，从最大值循环到最小值
• 处理鼠标滚轮和键盘导航手势
• 创建数据驱动的选择器，并支持 MVVM 模式

组件概览

SfDomainUpDown 控件为用户提供了一种简洁的方式，可通过点击向上／向下按钮或使用鼠标滚轮／键盘导航，从预定义列表中选择值。与数字微调控件不同，DomainUpDown 可处理任何类型的数据——字符串、对象或自定义类型。

主要功能：

• 支持使用 ItemsSource 进行数据绑定
• 为复杂对象提供自定义内容模板
• 可配置微调按钮对齐方式（左侧、右侧或两侧）
• 平滑的微调动画
• 自动反向循环行为
• 鼠标滚轮和键盘手势
• 丰富的样式和主题选项
• 适用于 MVVM 的架构

所需程序集：

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

文档与导航指南

入门

📄 阅读： references/getting-started.md

适用于以下需求：

• 安装并设置 DomainUpDown 控件
• 通过设计器或代码添加控件
• 了解程序集依赖项
• 创建第一个基本实现
• 配置 Value 属性
• 导入所需命名空间

数据填充与绑定

📄 阅读： references/data-population.md

适用于以下需求：

• 使用项目列表填充控件
• 使用 ItemsSource 属性绑定数据
• 创建数据模型和 ViewModel
• 使用 ContentTemplate 自定义显示
• 显示具有多个属性的复杂对象
• 实现 MVVM 数据绑定模式

微调按钮配置

📄 阅读： references/spin-button-alignment.md

适用于以下需求：

• 自定义微调按钮的位置
• 使用 SpinButtonsAlignment 属性
• 将按钮放在右侧（默认）
• 将按钮放在左侧
• 将按钮拆分到两侧（左侧递减，右侧递增）
• 为 UI 选择合适的对齐方式

外观与样式

📄 阅读： references/appearance-styling.md

适用于以下需求：

• 启用或禁用微调动画
• 使用 AccentBrush 自定义强调色
• 使用 UpDownStyle 设置向上／向下按钮的样式
• 创建自定义控件模板
• 修改边框、背景和前景
• 自定义字体和布局
• 构建完整的自定义主题

高级功能

📄 阅读： references/advanced-features.md

适用于以下需求：

• 启用自动反向循环行为
• 处理鼠标滚轮滚动
• 实现键盘导航
• 了解边缘情况
• 优化性能

---

→ 详细示例和实现模式请参阅参考文件。