[本文章是發行前版本文件，且隨時可能變更。]
用於接受使用者輸入的控制項。
Note
完整文件和原始程式碼可在 GitHub 程式碼元件存放庫中找到。
Important
- 這是預覽功能。
- 預覽功能不供生產時使用，而且可能功能受限。 這些功能是在正式發行前先行推出，讓客戶能夠搶先體驗並提供意見反應。
Description
微調按鈕 (SpinButton) 可讓使用者以遞增方式小幅度調整數值。 這主要用於數值，但也支援其他值。
此程式碼元件提供 Fluent UI SpinButton 控制項的封裝元件，以便在畫布和自訂頁面中使用。
關鍵屬性
| 名稱 | Description |
|---|---|
Label |
控制項的描述性標籤。 |
IconName |
Fluent UI 圖示的名稱 (請參閱 Fluent UI 圖示)。 |
Min |
控制項的最大值。 如果未提供，則控制項沒有最大值。 |
Max |
控制項的最小值。 如果未提供，則控制項沒有最小值。 |
Step |
控制項兩個相鄰值之間的差值。 如果未指定精度，則會使用此值來計算輸入的精度。 依此方式計算的精度永遠 >= 0。 |
Value |
控制項的目前值。 |
DefaultValue |
首次呈現時控制項的初始值。 |
Suffix |
用於定義任何單位的尾碼 (例如 cm、kg、ml) |
其他屬性
| 名稱 | Description |
|---|---|
AccessibilityLabel |
螢幕助讀程式 aria-label |
InputEvent |
要傳送至控制項的事件。 例如 SetFocus。 請參閱下文。 |
Theme |
接受使用 Fluent UI Theme Designer (windows.net) 產生的 JSON 字串。 將此留空將使用 Power Apps 定義的預設主題。 |
行為
- 支援將 SetFocus 當做
InputEvent。
Example
將 SpinButton 連接到編輯表單資料卡
- 解除鎖定資料卡
- 隱藏欄位的預設控制項
- 將 SpinButton 新增至資料卡中
- 更新資料卡的
Update屬性以參考SpinButton.Value輸出屬性
Limitations
此程式碼元件只能在畫布應用程式和自訂頁面中使用。