共用方式為

Power Apps 中的按鈕控制項

  • 發行項

使用者可以點擊或點選與應用程式互動的控制項。

描述

設定按鈕控制項的 OnSelect 屬性，在使用者點擊或點選控制項時執行一個或多個公式。

索引鍵屬性

OnSelect – 在使用者點選或按一下控制項時，要執行的動作。

Text – 控制項上顯示的文字，或使用者在控制項中輸入的文字。

其他屬性

Align – 文字相對於其控制項水平中心的位置。

AutoDisableOnSelect – 在執行 OnSelect 行為時自動停用控制項。

BorderColor – 控制項框線的色彩。

BorderStyle – 決定控制項的框線為實線、虛線、點線或無。

BorderThickness – 控制項框線的粗細。

Color – 控制項文字的色彩。

DisplayMode – 控制項是否允許使用者輸入 (Edit)、只顯示資料 (View) 或者已停用 (Disabled)。

DisabledBorderColor – 如果控制項的 DisplayMode 屬性設定為 Disabled，該控制項框線的色彩。

DisabledColor – 如果 DisplayMode 屬性設定為 Disabled，該控制項文字的色彩。

DisabledFill – 若其 DisplayMode 屬性設定為 Disabled，該控制項背景的色彩。

FocusedBorderColor – 當控制項為焦點時的控制項框線色彩。

FocusedBorderThickness – 當控制項為焦點時的控制項框線粗細。

Fill – 控制項背景的色彩。

Font – 文字可使用的字型家族名稱。

FontWeight – 控制項的文字字型粗細︰粗體、半粗體、正常，或較細。

Height – 控制項的頂端和底部邊緣之間的距離。

HoverBorderColor – 使用者將滑鼠游標停留在控制項上時，該控制項框線所呈現的色彩。

HoverColor – 使用者將滑鼠游標停留在控制項上時，該控制項文字所呈現的色彩。

HoverFill – 使用者將滑鼠游標停留在控制項上時，該控制項背景所呈現的色彩。

Italic – 控制項中的文字是否為斜體。

PaddingBottom – 控制項中文字與該控制項下邊緣之間的距離。

PaddingLeft – 控制項中文字與該控制項左邊緣之間的距離。

PaddingRight – 控制項中文字與該控制項右邊緣之間的距離。

PaddingTop – 控制項中文字與該控制項上邊緣之間的距離。

Pressed – 按下控制項時為 True，否則為 false。

PressedBorderColor – 使用者點選或按一下控制項時，該控制項框線所呈現的色彩。

PressedColor – 使用者點選或點擊控制項時，該控制項文字所呈現的色彩。

PressedFill – 使用者點選或點擊控制項時，該控制項背景所呈現的色彩。

RadiusBottomLeft – 控制項左下角的角度 (四捨五入)。

RadiusBottomRight – 控制項右下角的角度 (四捨五入)。

RadiusTopLeft – 控制項左上角的角度 (四捨五入)。

RadiusTopRight – 控制項右上角的角度 (四捨五入)。

Size – 控制項上文字的字型大小。

Strikethrough – 決定控制項上的文字中間是否有一條線。

TabIndex – 相對於其他控制項的鍵盤導覽順序。

Tooltip – 使用者將滑鼠停留在控制項上時所顯示的說明文字。

Underline – 決定控制項上的文字底部是否有一條線。

VerticalAlign – 文字相對於其控制項垂直中心的位置。

Visible – 控制項顯示或隱藏。

Width – 控制項左邊緣與右邊緣之間的距離。

X – 控制項左邊緣與其父容器 (沒有父容器時則為螢幕) 左邊緣之間的距離。

Y – 控制項頂部邊緣與其父容器 (沒有父容器時則為螢幕) 頂部邊緣之間的距離。

Navigate( ScreenName, ScreenTransitionValue )

範例

將基本公式新增至按鈕

  1. 新增**文字輸入** 控制項，並將其命名為 Source。

    不知道如何 新增、命名和設定控制項 嗎？

  2. 新增按鈕控制項，將其**Text** 屬性設定為 "Add"，然後將其 OnSelect 屬性設定為以下公式：
    UpdateContext({Total:Total + Value(Source.Text)})

    想要了解 UpdateContext 函數或 其他函數 的其他資訊嗎？

  3. 新增**標籤** 控制項，請在資料編輯列中將其**Text** 屬性設為值 (總和)，然後按 F5。

  4. 從 Source 清除預設文字，在其中輸入數字，然後點擊或點選 Add。

    標籤 控制項顯示您所輸入的數字。

  5. 從 Source 清除數字，在其中輸入其他數字，然後點擊或點選 Add。

    標籤 控制項顯示您所輸入兩個數字的總和。

  6. (非必要) 重複上述步驟一或多次。

  7. 若要返回預設工作區，請按下 Esc 鍵 (或者點擊或點選右上角的關閉圖示)。

使用多個公式組態按鈕

新增在各輸入項目之間清除文字輸入控制項的公式。

  1. 將 Source 的 HintText 屬性設定為「輸入數字」。

  2. 將 新增 的 OnSelect 屬性設定為以下公式︰

    UpdateContext({Total:Total + Value(Source.Text)});
    UpdateContext({ClearInput: ""})

    注意

    請以分號 ";" 分隔多個公式。

  3. 將 Source 的 Default 屬性設定為 ClearInput。

  4. 按下 F5 鍵，然後藉由將數個數字相加來測試應用程式。

新增另一個按鈕重設總計

新增第二個按鈕來清除計算之間的總計。

  1. 新增另一個按鈕控制項、將其 Text 屬性設定為 "Clear"，然後將其 OnSelect 屬性設為以下公式：

    UpdateContext({Total:0})

  2. 按下 F5 鍵，將數個數字相加，然後點擊或點選 Clear 重設總計。

變更按鈕的外觀

變更按鈕的圖形

根據預設，Power Apps 建立具有圓角的矩形按鈕控制項。 您可以對按鈕控制項的圖形進行基本修改，方法是設定其 Height、Width 和 Radius 屬性。

注意

Icons and Shapes 提供各種不同設計，而且可以執行一些與按鈕控制項相同的基本功能。 不過，Icons and Shapes 沒有**Text** 屬性。

  1. 新增按鈕控制項，將其 Height 和 Width 屬性設定為 300，以製作大方形按鈕。

  2. 修改 RadiusTopLeft、RadiusTopRight、RadiusBottomLeft 和 RadiusBottomRight 屬性調整各角落的彎曲度。 以下是不同圖形的範例，每個按鈕是從 300 x 300 方形按鈕開始：

變更當您將滑鼠游標停留在按鈕上面時的色彩

根據預設，按鈕控制項的填滿色彩將在您將滑鼠游標停留在上面時變暗 20%。 您可以藉由變更 HoverFill 屬性調整此行為，其使用 ColorFade 函數。 如果您將 ColorFade 公式設定為正數百分比，當您將滑鼠游標停留在按鈕上面時，色彩會變淡，而負數百分比則會讓色彩變濃。

  • 變更您建立其中一個按鈕的 HoverFill 屬性中的 ColorFade 百分比觀察效果。

您也可以指定按鈕控制項的色彩，方法是將其 HoverFill 屬性設定為包含 ColorValue 函數而非 ColorFade 函數的公式，如 ColorValue("Red") 所示。

注意

色彩值可以是任何 CSS 色彩定義，可能是一個名稱或十六進位值。

  • 在您建立的其中一個按鈕中，將 ColorFade 函數取代為 ColorValue 函數，並且觀察效果。

協助工具指南

色彩對比

螢幕助讀程式支援

  • Text 必須存在。

鍵盤支援

注意

是否能請您告知您偏好的慣用文件語言？ 請填寫問卷。 (請注意，本問卷為英文版)

完成問卷大約需要七分鐘。 本問卷將不會收集個人資料 (隱私權聲明)。