syncfusion-maui-toolkit-numericentry

实现 .NET MAUI 数值输入框

Syncfusion .NET MAUI 数值输入框控件旨在为数值数据提供友好且先进的输入体验。它支持多种数值格式，包括货币、百分比、小数以及其他可配置的数字类型。凭借丰富的功能，该控件在简化数值输入验证和格式设置的同时，提升了整体用户体验。

何时使用此技能

在用户需要以下功能时使用此技能：

• 需要输入货币的金融应用
• 包含百分比或小数数字字段的表单
• 需要设置最小值/最大值限制的数据录入场景
• 需要采用特定区域设置进行数字格式化的应用
• 科学计算器或计算器风格的数值输入
• 预算、定价或数量输入字段

组件概览

Syncfusion .NET MAUI 数值输入框（SfNumericEntry） 是一种专用输入控件，适用于数值数据录入，并提供高级功能：

主要功能

• 自动数值验证，支持自定义验证模式
• 丰富的格式选项（货币、百分比、小数、自定义模式）
• 值限制（最小值/最大值范围、空值处理）
• 特定区域设置的数字格式化与本地化
• 实时验证或失去焦点时验证
• 丰富的样式和自定义选项
• 内置值更改、焦点和完成事件
• 支持键盘导航的无障碍功能

---

文档与导航指南

入门

📄 阅读： references/getting-started.md

当用户需要首次设置 NumericEntry 时：

• 安装并配置 Syncfusion MAUI Toolkit 包
• 在 MauiProgram.cs 中注册处理程序
• 为 XAML 和 C# 添加命名空间导入
• 创建基本的 NumericEntry 控件
• 了解值编辑和验证模式（OnKeyFocus 与 OnLostFocus）
• 应用基本数字格式（货币、百分比、小数）
• 使用 AllowNull 配置空值行为

基本功能与配置

📄 阅读： references/basic-features.md

当用户希望自定义外观和交互时：

• 为空状态设置占位文本和颜色
• 显示/隐藏清除按钮并设置其样式
• 配置值更改模式（实时更新或失去焦点时更新）
• 自定义边框和笔画
• 设置文本的水平和垂直对齐方式
• 自定义字体（颜色、大小、字体系列、属性）
• 配置键盘返回类型和命令
• 管理光标位置和文本选择
• 创建自定义清除按钮图标

值格式化

📄 阅读： references/formatting.md

当用户需要格式化数值时：

• 使用 CustomFormat 属性和标准格式说明符（C、P、N）
• 使用特定区域设置的符号格式化货币值
• 使用 Value 或 Compute 显示模式格式化百分比
• 通过精度控制格式化小数
• 使用零占位符控制整数位数的显示
• 控制小数位精度
• 使用 # 和 0 占位符创建自定义格式模式
• 支持多种区域设置和本地化
• 使用 MaximumNumberDecimalDigits 限制小数位数

值限制

📄 阅读： references/restrictions.md

当用户需要限制或验证输入时：

• 使用 AllowNull 允许或禁止空值
• 设置最小值和最大值范围
• 了解超出范围时的验证行为
• 使用 IsEditable 禁止文本编辑
• 配置只读数值显示
• 处理边缘情况（空值与零、最小值行为）

事件和方法

📄 阅读： references/events-and-methods.md

当需要响应用户交互时：

• 使用 ValueChanged 事件处理值更改
• 使用 Completed 事件响应 Enter 键按下
• 使用 Focused 和 Unfocused 事件检测获得或失去焦点
• 使用 Focus() 方法以编程方式设置焦点
• 使用 Unfocus() 方法移除焦点
• 在事件参数中访问旧值和新值
• 实现表单提交和导航模式

---