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

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

内容

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

主要なプロパティ

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

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

追加のプロパティ

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

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

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

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

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

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

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

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

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

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

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

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

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

Fill – コントロールの背景色。

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

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

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

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

Format – ユーザー入力を数字のみに制限するか、またはすべてのテキストを許可するかを指定します。 数値 に設定すると、数字と特定の数字記号のみを入力できます。 サポートされる記号と形式はブラウザの言語によって異なり、個々のコントロールに設定することはできません。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

関連する関数

DateTimeValue( String )

例

データを収集する

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

色のコントラスト

• 標準の色のコントラスト要件 が適用されます。

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

• AccessibleLabel が存在する必要があります。

キーボードのサポート

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