SpinButton Control(预览版)

[本文为预发布文档,可能会发生变化。]

用于接受用户输入的控件。

备注

GitHub 代码组件存储库中的完整文档和源代码。

SpinButton 控件。

重要提示

  • 这是一项预览功能。
  • 预览功能不适合生产使用且功能可能受限。 这些功能在正式发布之前推出,以便客户可以提前使用并提供反馈。

说明

微调按钮 (SpinButton) 允许用户逐步地递增调整值。 主要用于数值,也支持其他值。

此代码组件提供了一个围绕 Fluent UI SpinButton 控件的包装器,用于画布和自定义页面。

键属性

客户 Description
Label 控件的描述性标签。
IconName Fluent UI 图标的名称(请参阅 Fluent UI 图标)。
Min 控件的最大值。 如果未提供,控件没有最大值。
Max 控件的最小值。 如果未提供,控件没有最小值。
Step 控件的两个相邻值之间的差。 如果没有给出精度,此值用于计算输入的精度。 按此方式计算的精度始终为 >= 0。
Value 控件的当前值。
DefaultValue 第一次呈现时控件的初始值。
Suffix 用于定义单位的后缀(例如,cm、kg、ml)

其他属性

客户 说明
AccessibilityLabel 屏幕阅读器 aria 标签
InputEvent 要发送到控件的事件。 例如,SetFocus。 请参阅以下内容。
Theme 接受使用 Fluent UI 主题设计器 (windows.net) 生成的 JSON 字符串。 将此属性留空将使用 Power Apps 定义的默认主题。

行为

示例

将 SpinButton 连接到编辑表单数据卡

  1. 解锁数据卡
  2. 隐藏字段的默认控件
  3. 将 SpinButton 添加到数据卡
  4. 更新数据卡的 Update 属性以引用 SpinButton.Value 输出属性

限制

此代码组件只能在画布应用和自定义页面中使用。