syncfusion-winforms-domainupdownext

在 Windows Forms 中实现 DomainUpdownExt

DomainUpdownExt 是一种高级 Windows Forms 控件，可提供带有微调按钮的现代下拉界面，用于选择值。它非常适合用户需要通过递增／递减按钮或键盘导航浏览预定义项目列表的场景。

何时使用此技能

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

• 创建带微调按钮导航的下拉控件
• 允许用户浏览预定义值列表
• 自定义控件外观（边框、颜色、样式）
• 启用方向键导航以选择值
• 配置文本对齐方式和微调按钮方向
• 处理用户交互和键盘事件
• 根据用户输入动态添加项目

组件概述

DomainUpdownExt 将文本框、微调按钮和预定义项目列表的功能结合在一起。与标准 ComboBox 不同，它只显示当前项目，并允许用户使用方向键或微调按钮浏览列表。

主要功能：

• 通过编程方式管理项目
• 自定义微调按钮（方向、对齐方式）
• 键盘支持（方向键、键盘事件）
• 自定义外观（边框、颜色、文本对齐方式）
• 处理状态变更事件
• 文本和项目验证

文档与导航指南

入门

📄 阅读： references/getting-started.md

• 程序集依赖项和项目设置
• 通过设计器添加控件
• 在代码中手动添加控件
• 创建第一个 DomainUpdownExt 控件
• 基本项目管理

文本和项目管理

📄 阅读： references/text-and-items.md

• 从集合中添加和移除项目
• 文本对齐属性
• MaxLength 配置
• 通过编程方式管理选定项目
• 项目验证模式

微调按钮控件

📄 阅读： references/spinbutton-control.md

• SpinOrientation 属性（水平或垂直）
• UpDownAlign 属性（左对齐或右对齐）
• 配置微调按钮外观
• 默认按钮行为

外观和自定义

📄 阅读： references/appearance-customization.md

• 边框样式和属性
• 背景色和前景色
• 3D 边框样式
• 自定义控件外观和风格
• 视觉外观模式

键盘导航和交互

📄 阅读： references/keyboard-and-interaction.md

• 方向键支持（InterceptArrowKeys 属性）
• KeyDown 事件处理
• UpButton 和 DownButton 方法
• 通过编程方式浏览值
• 键盘导航模式

高级用法和模式

📄 阅读： references/advanced-usage.md

• 根据用户输入在运行时添加项目
• 通过编程方式浏览值
• 事件处理策略
• 常见用例和模式
• 交互设计最佳实践

快速入门示例

创建一个包含项目并支持键盘导航的基本 DomainUpdownExt 控件：

using Syncfusion.Windows.Forms.Tools;
using System.Windows.Forms;

public class Form1 : Form
{
    private DomainUpDownExt domainUpDownExt1;

    public Form1()
    {
        // Create control
        domainUpDownExt1 = new DomainUpDownExt();
        
        // Add items
        domainUpDownExt1.Items.Add("Option 1");
        domainUpDownExt1.Items.Add("Option 2");
        domainUpDownExt1.Items.Add("Option 3");
        domainUpDownExt1.Items.Add("Option 4");
        
        // Configure appearance
        domainUpDownExt1.BorderStyle = BorderStyle.FixedSingle;
        domainUpDownExt1.BackColor = System.Drawing.Color.White;
        domainUpDownExt1.SpinOrientation = Orientation.Vertical;
        
        // Enable keyboard navigation
        domainUpDownExt1.InterceptArrowKeys = true;
        
        // Add to form
        this.Controls.Add(domainUpDownExt1);
    }
}

常见模式

模式 1：右对齐的垂直微调按钮

domainUpDownExt1.SpinOrientation = Orientation.Vertical;
domainUpDownExt1.UpDownAlign = LeftRightAlignment.Right;

模式 2：左对齐的水平微调按钮

domainUpDownExt1.SpinOrientation = Orientation.Horizontal;
domainUpDownExt1.UpDownAlign = LeftRightAlignment.Left;

模式 3：带彩色边框的自定义外观

domainUpDownExt1.BorderStyle = BorderStyle.FixedSingle;
domainUpDownExt1.BorderColor = System.Drawing.Color.Blue;
domainUpDownExt1.BackColor = System.Drawing.Color.LightGray;

模式 4：通过编程方式导航

domainUpDownExt1.UpButton();    // Navigate to previous item
domainUpDownExt1.DownButton();  // Navigate to next item

主要属性

属性	类型	用途	常见值
Items	Collection	获取项目集合	添加/移除项目
SelectedIndex	Int32	获取/设置所选项目的索引	0 到 Items.Count - 1
Text	String	获取/设置当前显示的文本	任意字符串
SpinOrientation	Orientation	控制微调按钮的方向	Vertical、Horizontal
UpDownAlign	LeftRightAlignment	控制微调按钮的位置	Left、Right
InterceptArrowKeys	Boolean	启用/禁用方向键导航	true、false
BorderStyle	BorderStyle	设置边框外观	FixedSingle、Fixed3D、None
BorderColor	Color	设置边框颜色	任意 System.Drawing.Color
BackColor	Color	设置背景颜色	任意 System.Drawing.Color
TextAlign	HorizontalAlignment	控制文本对齐方式	Left、Center、Right
MaxLength	Int32	最大文本长度	0 到 32768

常见用例

1. 数值范围选择 - 允许用户从预定义范围中选择数值
2. 类别导航 - 浏览预定义的类别或选项
3. 状态选择 - 在紧凑界面中从离散状态值中进行选择
4. 配置选项 - 从一组预定义配置值中进行选择
5. 优先级 - 从一组离散值中选择优先级
6. 难度级别 - 通过微调导航选择难度/强度级别