ハンドルを移動することでユーザーがオンまたはオフにできるコントロール。
Description
トグルは最近の UI 用に設計されていますが、チェック ボックスと同じように動作します。
重要なプロパティ
既定値 – ユーザーによって変更される前のコントロールの初期値。
値 – 入力コントロールの値。
追加のプロパティ
AccessibleLabel – スクリーン リーダーのラベル。
BorderColor – コントロールの境界線の色。
BorderStyle – コントロールの境界線が Solid、Dashed、Doted、None のいずれであるか。
BorderThickness – コントロールの境界線の太さ。
DisplayMode – コントロールでユーザー入力 (編集) を許可するか、データのみを表示するか (表示)、無効 (無効) にするかを指定します。
DisabledBorderColor – コントロールの DisplayMode プロパティが Disabled に設定されている場合のコントロールの境界線の色。
FalseFill – トグルがオフのときに塗りつぶしの色を切り替えます。
FalseHoverFill – トグルがオフの場合のトグル ホバー塗りつぶしの色。
FalseText – トグルがオフのときに表示されるテキスト。
塗りつぶし – コントロールの背景色。
FocusedBorderColor – コントロールがフォーカスされている場合のコントロールの境界線の色。
FocusedBorderThickness – コントロールがフォーカスされたときのコントロールの境界線の太さ。
HandleFill – トグル ハンドルの塗りつぶしの色。
Height – コントロールの上端と下端の間の距離。
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, "Price: $75", "Price: $100")F5 キーを押し、 MemberDiscount の値を変更します。
ラベルには、 MemberDiscount がオンかオフかに応じて異なる価格が表示されます。
既定のワークスペースに戻すには、Esc キーを押します。
アクセシビリティ ガイドライン
色のコントラスト
次の間に適切な色のコントラストが必要です。
- HandleFill と FalseFill
- HandleFill と FalseHoverFill
- HandleFill と TrueFill
- HandleFill と TrueHoverFill
- コントロールの外側の FalseFill と色
- コントロール外の FalseHoverFill と色
- コントロールの外側の TrueFill と色
- コントロールの外側にある TrueHoverFill と色
これは、 標準のカラー コントラスト要件に加えて行われます。
スクリーン リーダーのサポート
- AccessibleLabel が存在する必要があります。
- FalseText が存在する必要があります。
- TrueText が存在する必要があります。
ロービジョンのサポート
- ユーザーがトグル値をすばやく特定できるように、 ShowLabel を true に設定することを検討してください。
キーボードのサポート
- キーボード ユーザーが移動できるようにするには、TabIndex を 0 以上にする必要があります。
- フォーカス インジケーターは明確に表示する必要があります。 これを実現するには、FocusedBorderColor と FocusedBorderThickness を使用します。