mcpField
S
syncfusion-winforms-double-textbox

syncfusion-winforms-double-textbox

github.com/syncfusion开发280 次安装1 周前更新
代码仓库

关于 syncfusion-winforms-double-textbox

面向 Windows Forms 开发者的 Syncfusion DoubleTextBox 指南，用于处理双精度数值输入。内容涵盖格式设置、数值范围限制、值变更事件和键盘行为。

主要功能

  1. 01双精度值验证与格式化
  2. 02最小值和最大值限制
  3. 03小数与分组分隔符
  4. 04值变更事件处理
  5. 05键盘递增与递减

适用场景

  1. 01输入货币数值
  2. 02采集范围受限的百分比
  3. 03按指定精度录入测量值
  4. 04配置应用程序的数值参数

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/syncfusion/winforms-ui-components-skills --skill syncfusion-winforms-double-textbox

安装后在 Claude Code 中输入/syncfusion-winforms-double-textbox确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
appearance-and-behavior.md
event-handling-and-customization.md
getting-started.md
number-and-format-settings.md

详细介绍

实现 Syncfusion WinForms DoubleTextBox

何时使用此技能

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

  • 在 Windows Forms 应用程序中接受和显示双精度浮点值
  • 实现可自定义小数位数和分组分隔符的数值输入
  • 为数值输入设置最小值和最大值约束
  • 处理值更改事件，或使用键盘快捷键递增/递减值
  • 重写控件的默认按键处理逻辑，实现自定义行为
  • 根据正值、负值或零值应用视觉样式

组件概述

DoubleTextBox 是一种派生自 Windows Forms Framework 的专用文本框控件，可处理 double 类型的值。它提供：

  • 自动校验和格式化 double 值
  • 可自定义的数字显示（小数位数、分隔符、模式）
  • 最小值和最大值约束
  • 值更改和键盘输入的事件处理
  • 用于递增/递减值的键盘快捷键支持
  • 通过重写方法进行扩展

文档导航指南

入门

📄 阅读： references/getting-started.md

  • 程序集部署和设置
  • 通过设计器添加控件
  • 通过 C# 代码添加控件
  • 设置最大值和最小值
  • 自定义数字格式
数值和格式设置

📄 阅读： references/number-and-format-settings.md

  • 数字格式属性概览
  • 小数位数和分隔符
  • 数值范围配置（MaxValue/MinValue）
  • 横幅文本支持
  • 隐藏末尾零
外观和行为

📄 阅读： references/appearance-and-behavior.md

  • 边框样式设置
  • 不同数值状态下的颜色设置
  • 键盘支持配置
  • 溢出指示器显示
  • 禁用时保持激活状态的行为
事件处理和自定义

📄 阅读： references/event-handling-and-customization.md

  • DoubleValueChanged 事件处理
  • 用于递增/递减的键盘事件
  • 重写控件行为
  • 自定义 HandleSubtractKey 实现
  • 扩展控件功能

快速入门示例

C# 基本设置：

using Syncfusion.Windows.Forms.Tools;

// Create instance
DoubleTextBox doubleTextBox1 = new DoubleTextBox();
this.Controls.Add(doubleTextBox1);

// Set value constraints
doubleTextBox1.MaxValue = 100;
doubleTextBox1.MinValue = 0;

// Handle value changes
doubleTextBox1.DoubleValueChanged += (s, e) => 
    MessageBox.Show("Value changed");

关键属性：

  • DoubleValue - 获取或设置 double 值
  • MaxValue - 允许的最大值
  • MinValue - 允许的最小值
  • NumberDecimalDigits - 要显示的小数位数
  • NumberDecimalSeparator - 用作小数分隔符的字符
  • NumberGroupSeparator - 用作千位分隔符的字符

常见模式

模式 1：接受百分比输入（0-100）
doubleTextBox1.MinValue = 0;
doubleTextBox1.MaxValue = 100;
doubleTextBox1.NumberDecimalDigits = 2;
doubleTextBox1.Text = "50";
模式 2：接受货币值
doubleTextBox1.NumberDecimalDigits = 2;
doubleTextBox1.NumberGroupSeparator = ",";
doubleTextBox1.NumberDecimalSeparator = ".";
doubleTextBox1.Text = "1234.56";
模式 3：使用键盘递增/递减
doubleTextBox1.KeyDown += (s, e) =>
{
    if (e.KeyCode == Keys.Up)
        doubleTextBox1.DoubleValue++;
    else if (e.KeyCode == Keys.Down)
        doubleTextBox1.DoubleValue--;
};
模式 4：允许空值
doubleTextBox1.AllowNull = true;
doubleTextBox1.NullString = "";
doubleTextBox1.Text = "";

关键属性

属性类型用途
DoubleValuedouble获取或设置文本框的 double 值
MaxValuedouble允许的最大值
MinValuedouble允许的最小值
NumberDecimalDigitsint要显示的小数位数
NumberDecimalSeparatorstring小数分隔符字符
NumberGroupSeparatorstring千位分隔符字符
NumberGroupSizesint[]数字分组的大小
NumberNegativePatternint负数的模式
HideTrailingZerosbool隐藏显示中的末尾零
AllowNullbool允许空值
NullStringstring空值的字符串表示形式

常见用例

  1. 金融应用 - 输入保留两位小数的货币金额，并限制数值范围
  2. 测量数据输入 - 输入小数精度可变的科学数据
  3. 百分比字段 - 限制在 0–100 范围内并进行验证
  4. 配置设置 - 用于调整应用程序的数值参数
  5. 数据录入表单 - 具有格式化功能的数值字段，并进行验证
  6. 计算总计 - 使用键盘快捷键递增或递减数值

评论

支持 Markdown