PowerApps のトグル コントロールToggle control in PowerApps

ユーザーがハンドルを動かすことでオンまたはオフにできるコントロールです。A control that the user can turn on or off by moving its handle.

説明Description

トグルは最近の GUI 向けのデザインですが、動作はチェック ボックスと同じです。A toggle is designed for recent GUIs but behaves the same way as a check box.

主要なプロパティKey properties

Default – ユーザーが変更する前のコントロールの初期値です。Default – The initial value of a control before it is changed by the user.

Value – 入力コントロールの値です。Value – The value of an input control.

その他のプロパティAdditional properties

BorderColor – コントロールの境界線の色です。BorderColor – The color of a control's border.

BorderStyle – コントロールの境界線を Solid (実線)、Dashed (破線)、Dotted (点線)、None (なし) のいずれに指定します。BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness – コントロールの境界線の太さです。BorderThickness – The thickness of a control's border.

FocusedBorderThickness – キーボードでフォーカスした場合のコントロールの境界線の太さです。FocusedBorderThickness – The thickness of the control's border when it has keyboard focus.

DisplayMode – コントロールで、ユーザー入力を許可するか (Edit)、データの表示のみを許可するか (View)、許可しないか (Disabled) を設定します。DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

DisabledBorderColor – コントロールの DisplayMode プロパティが Disabled に設定されている場合のコントロールの境界線の色です。DisabledBorderColor – The color of a control's border if the control's DisplayMode property is set to Disabled.

FalseFill - トグルが無効な場合の、トグルの塗りつぶし色です。FalseFill – The toggle fill color when the toggle is off.

FalseHoverFill - トグルが無効な場合の、トグルのポイント時の塗りつぶし色です。FalseHoverFill – The toggle hover fill color when toggle is off.

FalseText - トグルが無効な場合に表示されるテキストです。FalseText – The text shown when the toggle is off.

Fill – コントロールの背景色です。Fill – The background color of a control.

Height – コントロールの上端と下端の距離です。Height – The distance between a control's top and bottom edges.

HoverBorderColor – コントロール上にユーザーがマウス ポインターを重ねているときのコントロールの境界線の色です。HoverBorderColor – The color of a control's border when the user keeps the mouse pointer on that control.

OnChange – ユーザーが (スライダーを調整するなどして) コントロールの値を変更した場合のアプリの反応を指定します。OnChange – How the app responds when the user changes the value of a control (for example, by adjusting a slider).

OnCheck – チェック ボックスまたはトグルの値が true に変わったときの、アプリの反応を指定します。OnCheck – How an app responds when the value of a checkbox or a toggle changes to true.

OnSelect – ユーザーがコントロールをタップまたはクリックした場合のアプリの反応を指定します。OnSelect – How the app responds when the user taps or clicks a control.

OnUncheck – チェック ボックスまたはトグルの値が false に変わったときの、アプリの反応を指定します。OnUncheck – How an app responds when the value of a checkbox or a toggle changes to false.

PressedBorderColor – コントロールをユーザーがタップまたはクリックしたときのコントロールの境界線の色です。PressedBorderColor – The color of a control's border when the user taps or clicks that control.

RailFill – 値が false の場合の、トグル コントロール内の四角形の背景色、またはスライダー コントロールのハンドルの右側の線の色です。RailFill – The background color of the rectangle in a toggle control when its value is false or the color of the line to the right of the handle in a slider control.

RailHoverFill – 値が false の場合に、トグル コントロールまたはスライダーにポインターを合わせたときの、トグル コントロール内の四角形の背景色、またはスライダー コントロールのハンドルの右側の線の色です。RailHoverFill – When you hover on a toggle control or a slider, the background color of the rectangle in a toggle control when its value is false or the color of the line to the right of the handle in a slider control.

Reset – コントロールを既定値に戻すかどうかを指定します。Reset – Whether a control reverts to its default value.

ShowLabel - テキスト ラベルをトグル コントロールの横に表示するかどうかを指定します。ShowLabel – Whether a text label is shown beside the toggle control.

TabIndex – ゼロ以外の値に設定すると、実行時のコントロールのタブの順序をカスタマイズできます。TabIndex – Customizes the tab order of controls at runtime when set to a non-zero value.

TextPosition - ラベルをトグル コントロールの右側と左側のどちらにするかを指定します。TextPosition – Whether the label is to the left or the right of the toggle control.

Tooltip – ポインターをコントロールに合わせたときに表示される説明テキストです。Tooltip – Explanatory text that appears when the user hovers over a control.

TrueFill - トグルが有効な場合の、トグルの塗りつぶし色です。TrueFill – Toggle fill color when the toggle is on.

TrueHoverFill - トグルが有効な場合の、トグルのポイント時の塗りつぶし色です。TrueHoverFill – Toggle hover fill color when the toggle is on.

TrueText - トグルが有効な場合に表示されるテキストです。TrueText – Text shown when the toggle is on.

ValueFill – 値が true の場合の、トグル コントロール内の四角形の背景色、またはスライダー コントロールのハンドルの左側の線の色です。ValueFill – The background color of the rectangle in a toggle control when its value is true or the color of the line to the left of the handle in a slider control.

ValueHoverFill – 値が true の場合に、トグル コントロールまたはスライダーをポイントしたときの、トグル コントロール内の四角形の背景色、またはスライダー コントロールのハンドルの左側の線の色です。ValueHoverFill – When you keep the mouse pointer on a toggle control or a slider, the background color of the rectangle in a toggle control when its value is true or the color of the line to the left of the handle in a slider control.

Visible – コントロールを表示するか非表示にするかを指定します。Visible – Whether a control appears or is hidden.

Width – コントロールの左端と右端の間の距離です。Width – The distance between a control's left and right edges.

X – コントロールの左端とその親コンテナー (親コンテナーがない場合は画面) の左端間の距離です。X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

Y – コントロールの上端とその親コンテナー (親コンテナーがない場合は画面) の上端間の距離です。Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

If( Condition, Result )If( Condition, Result )

Example

  1. トグルを追加し、名前を MemberDiscount にします。Add a toggle, and name it MemberDiscount.

    コントロールの追加、命名、構成についてはこちらをご覧くださいDon't know how to add, name, and configure a control?

  2. ラベルを追加し、その Text プロパティを次の数式に設定します。Add a label, and set its Text property to this formula:
    If(MemberDiscount.Value = true, "Price: $75", "Price: $100")If(MemberDiscount.Value = true, "Price: $75", "Price: $100")

    If 関数またはその他の関数の詳細については各関連記事を参照してください。Want more information about the If function or other functions?

  3. F5 キーを押し、MemberDiscount の値を変更します。Press F5, and change the value of MemberDiscount.

    MemberDiscount がオンかオフかに応じて、ラベルに異なる価格が表示されます。The label shows a different price, depending on whether MemberDiscount is on or off.

  4. 既定のワークスペースに戻るには、Esc キーを押します。To return to the default workspace, press Esc.