Power Apps 中的切换控件

用户可通过移动其句柄打开或关闭的控件。

描述

切换设计用于最新的 GUI,但行为方式与复选框相同。

关键属性

Default – 用户更改控件前的初始值。

Value – 输入控件的值。

其他属性

AccessibleLabel – 屏幕阅读器标签。

BorderColor – 控件边框的颜色。

BorderStyle – 控件边框是 SolidDashedDotted 还是 None

BorderThickness – 控件边框的粗细。

DisplayMode – 此控件是允许用户输入 (Edit)、仅显示数据 (View),还是已禁用 (Disabled)。

DisabledBorderColor – 控件的 DisplayMode 属性设置为 Disabled 时,该控件边框的颜色。

FalseFill – 切换处于关闭状态时的切换填充颜色。

FalseHoverFill – 切换处于关闭状态时的切换悬停填充颜色。

FalseText – 切换处于关闭状态时显示的文本。

Fill – 控件的背景色。

FocusedBorderColor – 当聚焦到控件时,控件的边框颜色。

FocusedBorderThickness – 当聚焦到控件时,控件的边框粗细。

HandleFill – 切换句柄的填充颜色。

Height – 控件上边缘和下边缘之间的距离。

HoverBorderColor – 用户将鼠标指针停留在控件上时,该控件边框的颜色。

OnChange - 用户更改控件的值(例如,通过调整滑块)时要执行的操作。

OnCheck – 复选框或切换控件的值更改为 true 时要执行的操作。

OnSelect – 当用户点击或单击控件时要执行的操作。

OnUncheck – 复选框或切换控件的值更改为 false 时要执行的操作。

PressedBorderColor – 用户在点击或单击控件时,该控件边框的颜色。

RailFill – 切换控件的值为 false 时该控件中矩形的背景色,或滑块控件中控点右侧线条的颜色。

RailHoverFill – 将鼠标悬停在切换控件或滑块上时,切换控件(其值为 false)中矩形的背景色,或滑块控件中控点右侧线条的颜色。

Reset – 控件是否还原为其默认值。

ShowLabel – 是否在切换控件旁边显示文本标签。

TabIndex – 相对于其他控件的键盘导航顺序。

TextPosition – 标签位于切换控件的左侧还是右侧。

Tooltip – 用户将鼠标悬停在控件上时显示的解释性文本。

TrueFill – 切换处于打开状态时的切换填充颜色。

TrueHoverFill – 切换处于打开状态时的切换悬停填充颜色。

TrueText – 切换处于打开状态时显示的文本。

ValueFill – 切换控件的值为 true 时该控件中矩形的背景色,或滑块控件中控点左侧线条的颜色。

ValueHoverFill – 将鼠标指针停留在切换控件或滑块上时,切换控件(其值为 true)中矩形的背景色,或滑块控件中控点左侧线条的颜色。

Visible – 控件显示还是隐藏。

Width – 控件左边缘和右边缘之间的距离。

X – 控件左边缘与其父容器(如果没有父容器,则为屏幕)左边缘之间的距离。

Y – 控件上边缘与其父容器(如果没有父容器,则为屏幕)上边缘之间的距离。

If( Condition, Result )

示例

  1. 添加一个切换控件,并将其命名为 MemberDiscount

    不知道如何添加、命名和配置控件

  2. 添加一个标签,然后将其 文本 属性设置为以下公式:
    If(MemberDiscount.Value = true, "Price: $75", "Price: $100")

    想要了解有关 If 函数或其他函数的详细信息?

  3. 按 F5,并更改 MemberDiscount 的值。

    标签显示不同的价格,具体取决于是否已启用 MemberDiscount

  4. 要返回默认工作区,按 Esc。

辅助功能准则

颜色对比度

在以下项之间必须有足够的颜色对比度:

  • HandleFillFalseFill
  • HandleFillFalseHoverFill
  • HandleFillTrueFill
  • HandleFillTrueHoverFill
  • FalseFill 和控件范围之外的颜色
  • FalseHoverFill 和控件范围之外的颜色
  • TrueFill 和控件范围之外的颜色
  • TrueHoverFill 和控件范围之外的颜色

这是除标准颜色对比度以外的要求。

屏幕阅读器支持

  • AccessibleLabel 必须存在。
  • FalseText 必须存在。
  • TrueText 必须存在。

弱视支持

  • 请考虑将 ShowLabel 设置为 true,以便用户能够快速确定切换值。

键盘支持