当前位置：首页 > java >正文

WinForm真入门(17)——NumericUpDown控件详解

java 2025/5/6 2:18:11

一、基本概念‌

NumericUpDown 是 Windows 窗体中用于数值输入的控件，由文本框和上下调节按钮组成。用户可通过以下方式调整数值：

点击调节按钮增减数值
键盘直接输入
使用方向键调整
适用于需要限制数值范围或精确控制的场景（如年龄、参数配置、数量选择等）。

‌二、核心属性‌

1‌、数值范围控制‌

Minimum：允许的最小值（默认 0）
Maximum：允许的最大值（默认 100）
Value：当前显示的数值（默认 0）
Increment：点击调节按钮时的增减步长（默认 1）

2‌、显示格式控制‌

DecimalPlaces：设置小数位数（如 2 表示显示两位小数）
ThousandsSeparator：启用千位分隔符（如 1,000）

3‌、交互控制‌

ReadOnly：禁止用户直接输入（仅允许按钮调节）
InterceptArrowKeys：启用方向键控制数值增减（默认 true）

三、常用方法‌

UpButton()：模拟点击“向上”按钮，增加数值
DownButton()：模拟点击“向下”按钮，减少数值
UpdateEditText()：强制更新文本框显示（如自定义格式化后调用）

‌四、使用案例‌

1‌、限制输入范围与步长‌

numericUpDown1.Minimum = 0;
numericUpDown1.Maximum = 1000;
numericUpDown1.Increment = 10;  // 每次增减10:ml-citation{ref="1,6" data="citationList"}

‌2、格式化显示数值‌

numericUpDown1.DecimalPlaces = 2;     // 显示两位小数
numericUpDown1.ThousandsSeparator = true;  // 显示千位分隔符:ml-citation{ref="1,6" data="citationList"}

‌3、实时更新界面‌

private void numericUpDown1_ValueChanged(object sender, EventArgs e) {label1.Text = "当前值：" + numericUpDown1.Value.ToString("N2"); // 带两位小数格式化:ml-citation{ref="1,7" data="citationList"}
}

4‌、禁用非数字输入‌

numericUpDown1.KeyPress += (s, e) => {if (!char.IsControl(e.KeyChar) && !char.IsDigit(e.KeyChar)) {e.Handled = true;  // 拦截非数字输入:ml-citation{ref="6,8" data="citationList"}}
};