使用者可以透過移動其控制碼來開啟或關閉的控制項。
Description
切換是針對最近的 GUI 所設計，但其行為方式與核取方塊相同。
索引鍵屬性
預設值 – 使用者變更控制項之前的初始值。
值 — 輸入控制項的值。
其他屬性
AccessibleLabel — 螢幕助讀程式的標籤。
BorderColor – 控制項框線的色彩。
BorderStyle – 控制項的框線是 Solid、 Dashed、 Doted 還是 None。
BorderThickness — 控制項邊框的粗細。
DisplayMode – 控制項是否允許使用者輸入 （編輯） 、只顯示資料 （檢視） 或停用 （已停用） 。
DisabledBorderColor -如果控制項的 DisplayMode 屬性設定為 Disabled，則控制項框線的色彩。
FalseFill – 切換關閉時的切換填滿顏色。
FalseHoverFill – 切換關閉時的切換暫留填滿顏色。
FalseText — 切換關閉時顯示的文字。
填滿 – 控制項的背景色彩。
FocusedBorderColor – 控制項聚焦時控制項框線的色彩。
FocusedBorderThickness – 控制項聚焦時控制項框線的粗細。
HandleFill — 切換控點的填滿色彩。
高度 – 控制項頂部和底部邊緣之間的距離。
HoverBorderColor – 當使用者將滑鼠指標保留在控制項上時，控制項框線的色彩。
OnChange — 使用者變更控制項值時要執行的動作 （例如，透過調整滑桿）。
OnCheck — 核取方塊或切換的值變更為 true 時要執行的動作。
OnSelect – 使用者點選或按一下控制項時要執行的動作。
OnUncheck — 核取方塊或切換的值變更為 false 時要執行的動作。
PressedBorderColor – 使用者點選或按一下控制項時，控制項框線的色彩。
RailFill – 切換控制項中矩形的背景色彩，當其值為 false 時，或滑桿控制項中控點右側線條的色彩。
RailHoverFill – 當您將滑鼠停留在切換控制項或滑桿上時，切換控制項中矩形的背景色彩（其值為 false 時）或滑桿控制項中控點右側線條的色彩。
重設 — 控制項是否還原為其預設值。
ShowLabel — 切換控制項旁邊是否顯示文字標籤。
TabIndex – 與其他控制項相關的鍵盤導覽順序。
TextPosition — 標籤是在切換控制項的左側還是右側。
工具提示 – 當使用者將滑鼠停留在控制項上時出現的說明文字。
TrueFill – 切換開啟時切換填充顏色。
TrueHoverFill – 切換切換開啟時的暫留填滿顏色。
TrueText – 切換開啟時顯示的文字。
ValueFill – 切換控制項中矩形的背景色彩，當其值為 true 時，或滑桿控制項中控制碼左側線條的色彩。
ValueHoverFill – 當您將滑鼠指標停留在切換控制項或滑桿上時，切換控制項中矩形的背景色彩 （當其值為 true 時） 或滑桿控制項中控點左側的線條色彩。
可見 — 控制項是否顯示或隱藏。
寬度 – 控制項的左右邊緣之間的距離。
X – 控制項左邊緣與其父容器 (沒有父容器時則為螢幕) 左邊緣之間的距離。
Y – 控制項頂部邊緣與其上層容器 (沒有上層容器時則為螢幕) 頂部邊緣之間的距離。
相關功能
Example
新增切換開關，並將其命名為 MemberDiscount。
不知道如何 新增、命名和設定控制項？
新增標籤，並將其 Text 屬性設定為下列公式：
If（MemberDiscount.Value = true， “價格：$75”， “價格：$100”）按 F5，然後變更 MemberDiscount 的值。
標籤會顯示不同的價格，視 MemberDiscount 是開啟還是關閉而定。
若要返回預設工作區，請按 Esc 鍵。
協助工具指導方針
色彩對比
以下兩者之間必須有足夠的色彩對比：
- HandleFill 和 FalseFill
- HandleFill 和 FalseHoverFill
- HandleFill 和 TrueFill
- HandleFill 和 TrueHoverFill
- FalseFill 和控制項外部的色彩
- FalseHoverFill 和控制項外部的色彩
- TrueFill 和控制項外部的色彩
- TrueHoverFill 和控制項外部的色彩
這是 對標準顏色對比度要求的補充。
支援螢幕助讀程式
- AccessibleLabel 必須存在。
- FalseText 必須存在。
- TrueText 必須存在。
低視力支持
- 請考慮將 ShowLabel 設定為 true ，讓使用者可以快速判斷切換值。
鍵盤支援
- TabIndex 必須為零或更大，鍵盤使用者才能流覽至它。
- 焦點指示器必須清晰可見。 使用 FocusedBorderColor 和 FocusedBorderThickness 來達成此目的。