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. SourceHintText 屬性設定為「輸入數字」。

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

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

    注意

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

  3. SourceDefault 屬性設定為 ClearInput

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

新增另一個按鈕重設總計

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

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

    UpdateContext({Total:0})

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

變更按鈕的外觀

變更按鈕的圖形

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

注意

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

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

  2. 修改 RadiusTopLeftRadiusTopRightRadiusBottomLeftRadiusBottomRight 屬性調整各角落的彎曲度。 以下是不同圖形的範例,每個按鈕是從 300 x 300 方形按鈕開始:

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

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

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

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

注意

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

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

協助工具指南

色彩對比

螢幕助讀程式支援

  • Text 必須存在。

鍵盤支援

注意

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

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