SpinButton 控制項 (預覽版)

[本文章是發行前版本文件，且隨時可能變更。]

用於接受使用者輸入的控制項。

注意

完整文件和原始程式碼可在 GitHub 程式碼元件存放庫中找到。

重要

• 這是預覽功能。
• 預覽功能不供生產時使用，而且可能功能受限。 這些功能是在正式發行前先行推出，讓客戶能夠搶先體驗並提供意見反應。

描述

微調按鈕 (SpinButton) 可讓其他人以遞增方式小幅度調整值。 這主要用於數值，但也支援其他值。

此程式碼元件提供 Fluent UI SpinButton 控制項的包裝函式，以便在畫布 & 自訂頁面中使用。

索引鍵屬性

姓名	Description
Label	控制項的描述性標籤。
IconName	Fluent UI 圖示的名稱 (請參閱 Fluent UI 圖示)。
Min	控制項的最大值。 如果未提供，則控制項沒有最大值。
Max	控制項的最小值。 如果未提供，則控制項沒有最小值。
Step	控制項兩個相鄰值之間的差值。 如果未指定有效位數，則會使用此值來計算輸入的有效位數。 依此方式計算的有效位數永遠 >= 0。
Value	控制項的目前值。
DefaultValue	首次呈現時控制項的初始值。
Suffix	用於定義任何單位的尾碼 (例如 cm、kg、ml)

其他屬性

姓名	描述
AccessibilityLabel	螢幕助讀程式 aria-label
InputEvent	要傳送到控制項的事件。 例如 SetFocus。 請參閱下文。
Theme	接受使用 Fluent UI Theme Designer (windows.net) 產生的 JSON 字串。 將此留空將使用 Power Apps 定義的預設主題。

行為

• 支援將 SetFocus 視為 InputEvent。

範例

將 SpinButton 連接到編輯表單資料卡

1. 解除鎖定資料卡
2. 隱藏欄位的預設控制項
3. 將 SpinButton 新增至資料卡中
4. 更新資料卡的 Update 屬性以參考 SpinButton.Value 輸出屬性

限制

此程式碼元件只能在畫布應用程式和自訂頁面中使用。