Power Apps のテキスト入力コントロール

ユーザーがテキスト、数値、およびその他のデータを入力できるボックス。

内容

ユーザーは、テキスト入力コントロールに入力してデータを指定できます。 アプリの構成方法に応じて、そのデータをデータ ソースに追加したり、一時的な値を計算するために使用したり、また他の方法で組み込んだりすることができます。

主要なプロパティ

Default – ユーザーが変更する前のコントロールの初期値です。

テキスト – コントロールに表示されるテキスト、またはユーザーがコントロールに入力するテキスト。

追加のプロパティ

AccessibleLabel – スクリーン リーダー用のラベル。

配置 – コントロールの水平方向の中心に対するテキストの位置。

BorderColor – コントロールの境界線の色。

BorderStyle – コントロールの境界線が 実線破線点線、または なし かどうか。

BorderThickness – コントロールの境界線の太さ。

Clear – テキスト入力コントロールに、ユーザーがタップまたはクリックして、そのコントロールの内容をクリアできる「X」を表示するかどうかを指定します。

– コントロールのテキストの色。

DelayOutput – true に設定した場合、1/2 秒の遅延の後、ユーザー入力が登録されます。 負荷のかかる操作をユーザーがテキストの入力を完了するまで遅らせる場合 (つまり、入力が他の数式で使用される際にフィルタ処理する場合) に便利です。

DisplayMode – コントロールがユーザー入力を許可するか (編集)、データのみを表示するか (表示)、または無効にするか (無効) どうか。

DisabledBorderColor – コントロールの DisplayMode プロパティが 無効 に設定されている場合のコントロールの境界線の色。

DisabledColor – コントロールの DisplayMode プロパティが 無効 に設定されている場合のコントロール内のテキストの色。

DisabledFill – コントロールの DisplayMode プロパティが 無効 に設定されている場合のコントロールの背景色。

EnableSpellCheck – テキスト入力コントロールがブラウザーのスペル チェック機能を使用するかどうかを指定します。 Power Apps for Windows はこのプロパティをサポートしていません。

塗りつぶし – コントロールの背景色。

FocusedBorderColor – コントロールがフォーカスされているときのコントロールの境界線の色。

FocusedBorderThickness – コントロールがフォーカスされているときのコントロールの境界線の太さ。

フォント – テキストを表示するフォントのファミリーの名前。

FontWeight – コントロール内のテキストの太さ: 太字中太標準、または 細字

Format – ユーザー入力を数字のみに制限するか、またはすべてのテキストを許可するかを指定します。

高さ – コントロールの上端と下端間の距離。

HintText – テキスト入力コントロールが空の場合に表示される薄いグレーのテキストです。

HoverBorderColor – ユーザーがコントロール上にマウス ポインターを重ねているときのコントロールの境界線の色。

HoverColor – ユーザーがコントロールにマウス ポインターを重ねているときのコントロール内のテキストの色。

HoverFill – ユーザーがコントロールにマウス ポインターを重ねているときのコントロールの背景色。

斜体 – コントロール内のテキストを斜体にするかどうか。

LineHeight – たとえば、テキストの行間またはリスト内の項目間などの距離です。

MaxLength – ユーザーがテキスト入力コントロールに入力できる文字数です。

Mode – コントロールのモードは、SingleLineMultiLine、または Password です。

OnChange – ユーザーが (スライダーを調整するなどして) コントロールの値を変更したときに実行するアクション。

OnSelect – ユーザーがコントロールをタップまたはクリックしたときに実行するアクション。

PaddingBottom – コントロール内のテキストとそのコントロールの下端間の距離。

PaddingLeft – コントロール内のテキストとそのコントロールの左端間の距離。

PaddingRight – コントロール内のテキストとそのコントロールの右端間の距離。

PaddingTop – コントロール内のテキストとそのコントロールの上端間の距離。

PressedBorderColor – ユーザーがコントロールをタップまたはクリックしたときのコントロールの境界線の色。

PressedColor – ユーザーがコントロールをタップまたはクリックしたときのコントロール内のテキストの色。

PressedFill – ユーザーがコントロールをタップまたはクリックしたときのコントロールの背景色。

RadiusBottomLeft – コントロールの左下隅を丸める度合い。

RadiusBottomRight – コントロールの右下隅を丸める度合い。

RadiusTopLeft – コントロールの左上隅を丸める度合い。

RadiusTopRight – コントロールの右上隅を丸める度合い。

Reset – コントロールを既定値に戻すかどうかを指定します。

サイズ – コントロールに表示されるテキストのフォント サイズ。

Strikethrough – コントロールに表示されるテキストに取り消し線を付けるかどうか。

TabIndex – 他のコントロールに関連するキーボード ナビゲーションの順序。

ツールヒント – ユーザーがコントロールにカーソルを置くときに表示される説明テキスト。

下線 – コントロールに表示されるテキストの下に線を引くかどうか。

VirtualKeyboardMode – アプリ ユーザーのタッチ スクリーンに表示される仮想キーボードのタイプで、テキストまたは数値。 既定値は Format プロパティにより決定されます。 デバイスのサポートはそれぞれ異なります。 iOS を実行しているデバイスは、バージョン 12.2 以降が必要です。 Android の推奨バージョンは 9.0 で、数字キーボードの機能は Android デバイスによって異なります。 Windows 10 はこのプロパティをサポートしていません。

表示 – コントロールが表示されるか非表示になるか。

– コントロールの左端と右端間の距離。

X – コントロールの左端とその親コンテナー (親コンテナーがない場合は画面) の左端間の距離。

Y – コントロールの上端とその親コンテナー (親コンテナーがない場合は画面) の上端間の距離。

DateTimeValue( String )

データを収集する

  1. 2 つのテキスト入力コントロールを追加し、それらに inputFirstinputLast という名前を付けます。

    コントロールの追加、名前付け、構成 についてはこちらをご覧ください。

  2. ボタンを追加し、その テキスト プロパティを Add に設定し、その OnSelect プロパティを次の式に設定します。
    Collect(Names, {FirstName:inputFirst.Text, LastName:inputLast.Text})

    Collect 関数または その他の関数 については、各関連記事を参照してください。

  3. 縦/垂直方向にテキスト ギャラリーを追加し、その Items プロパティを Names に設定し、Subtitle1テキスト プロパティを ThisItem.FirstName に設定します。

  4. (任意) テンプレート ギャラリーで、下部の Body1 というラベルを削除し、ギャラリーの TemplateSize プロパティを 80 に設定します。

  5. F5 キーを押して、inputFirstinputLast に文字列を入力して、追加 ボタンをクリックまたはタップします。

  6. (任意) 他の名前をコレクションに追加し、Esc キーを押して、既定のワークスペースに戻ります。

パスワードの入力を求める

  1. テキスト入力コントロールを追加し、それに inputPassword という名前を付けて、その Mode プロパティを Password に設定します。

  2. ラベルを追加し、その テキスト プロパティを次の数式に設定します。
    If(inputPassword.Text = "P@ssw0rd", "Access granted", "Access denied")

    If 関数または その他の関数 の詳細については各関連記事を参照してください。

  3. F5 キーを押し、inputPasswordP@ssw0rd と入力します。

    パスワードの入力が完了すると、ラベルの Access denied の表示が停止し、Access granted の表示が開始します。

  4. 既定のワークスペースに戻るには、Esc キーを押します。

  5. (任意) 矢印などのコントロールを追加し、それを別の画面に移動するように構成し、ユーザーがパスワードを入力した後にのみ表示するようにします。

  6. (任意) ボタンを追加し、その テキスト プロパティに Sign in と表示されるように設定した後、タイマーを追加し、ユーザーが間違ったパスワードを入力して Sign in ボタンをクリックまたはタップした場合に、一定の時間テキスト入力コントロールを無効にします。

アクセシビリティ ガイドライン

色のコントラスト

スクリーン リーダー サポート

キーボードのサポート

  • TabIndex を 0 以上にして、キーボード ユーザーがそこに移動できるようにする必要があります。
  • フォーカス インジケーターは明確に表示する必要があります。 これを実現するには FocusedBorderColor および FocusedBorderThickness を使用します。