40 lines
2.2 KiB
Markdown
40 lines
2.2 KiB
Markdown
---
|
||
name: handycontrol-wpf-numeric-up-down
|
||
description: "实现、配置或排查 HandyControl WPF 的 NumericUpDown 数值选择控件(NumericUpDown)。适用于该扩展控件的 XAML、绑定、事件和模板;不用于 Avalonia 或其他厂商控件。"
|
||
---
|
||
|
||
# HandyControl WPF NumericUpDown 数值选择控件
|
||
|
||
实现或排查 **NumericUpDown 数值选择控件**。相关类型:`NumericUpDown`。
|
||
|
||
## 接入
|
||
|
||
程序集/NuGet 为 `HandyControl`,XAML 命名空间为
|
||
`xmlns:hc="https://handyorg.github.io/handycontrol"`,C# 控件命名空间为 `HandyControl.Controls`。
|
||
在 `App.xaml` 合并 `pack://application:,,,/HandyControl;component/Themes/SkinDefault.xaml`,
|
||
然后合并 `pack://application:,,,/HandyControl;component/Themes/Theme.xaml`。
|
||
已有主题配置时先检查,避免重复合并。版本和目标框架以使用方项目为准。
|
||
|
||
## 实现
|
||
|
||
先读 [API 声明与继承关系](references/api.md),再按需求查看
|
||
[文档、样式与示例导航](references/usage.md)。源码路径相对于 HandyControl 仓库根目录;
|
||
在本仓库优先读本地文件,安装到其他项目后使用内附声明与链接,遇到版本差异检查实际引用版本的源码。
|
||
不要将 Demo 的 langs、ex:Lang、ViewModelLocator 或示例资源直接复制进使用方项目。
|
||
|
||
Value 是 double;范围属性是 Minimum / Maximum,步长是 Increment,不能照搬 Syncfusion 的 MinValue / MaxValue / Step。DecimalPlaces 为 int?,仅控制显示。ValueChanged 的事件参数使用 FunctionEventArgs<double>,读取 Info;绑定时显式指定 Mode=TwoWay。
|
||
|
||
用目标项目现有的 MVVM 方式绑定;需要回写时明确 TwoWay 和更新时机,
|
||
不要假定所有依赖属性默认双向绑定。原生 WPF 与 HandyControl 同名类型使用命名空间区分。
|
||
交付时运行目标框架的构建,并在窗口加载后检查模板、绑定错误、空值和相关输入边界;
|
||
无法运行 WPF 时明确说明尚未验证 UI 行为。
|
||
|
||
## 最小片段
|
||
|
||
依赖上面的应用资源配置;Binding 路径由使用方 ViewModel 提供。
|
||
|
||
```xml
|
||
<hc:NumericUpDown Minimum="0" Maximum="100" Increment="0.5"
|
||
DecimalPlaces="2" Value="{Binding Amount, Mode=TwoWay}"/>
|
||
```
|