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

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

Description

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

重要なプロパティ

既定値 – ユーザーによって変更される前のコントロールの初期値。

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

追加のプロパティ

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

[配置] – コントロールの水平方向の中心を基準にしたテキストの位置。

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

BorderStyle – コントロールの境界線が Solid、Dashed、Doted、None のいずれであるか。

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

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

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

DelayOutput – true に設定すると、5 分の 1 の遅延後にユーザー入力が登録されます。 ユーザーがテキストの入力を完了するまでコストのかかる操作を遅らせる場合に便利です (つまり、他の数式で入力を使用する場合のフィルター処理に役立ちます)。

DisplayMode – コントロールでユーザー入力 (編集) を許可するか、データのみを表示するか (表示)、無効 (無効) にするかを指定します。

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

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

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

EnableSpellCheck – テキスト入力コントロールがブラウザーのスペル チェック関数を使用する必要があるかどうか。 Power Apps for Windows では、このプロパティはサポートされていません。

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

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

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

フォント – テキストが表示されるフォントファミリの名前。

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

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

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

HintText – 入力テキスト コントロールに表示される淡色の灰色のテキスト (空の場合)。

HoverBorderColor – ユーザーがそのコントロールにマウス ポインターを置いたままにしたときのコントロールの境界線の色。

HoverColor – ユーザーがマウス ポインターを置いたままにしたときのコントロール内のテキストの色。

HoverFill – ユーザーがマウス ポインターをその上に置いたままにしたときのコントロールの背景色。

斜体 – コントロール内のテキストが斜体かどうかを指定します。

LineHeight – リスト内のテキストまたは項目の行間の距離です。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

リセット – コントロールが既定値に戻るかどうか。

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

取り消し線 – コントロールに表示されるテキストを線で表示するかどうかを指定します。

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

ヒント – ユーザーがコントロールの上にマウス ポインターを置いたときに表示される説明テキスト。

下線 – コントロールに表示されるテキストの下に行を表示するかどうかを指定します。

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

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

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

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

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

関連する関数

DateTimeValue( String )

例示

データの収集

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

   コントロールを追加、名前付け、構成する方法がわからない場合

2. ボタンを追加し、 Text プロパティを [追加] に設定し、 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 が拒否されたことを 示すメッセージが表示され、 アクセス許可の表示が開始されます。

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

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

6. (省略可能)ボタンを追加し、 その Text プロパティを構成して サインインを表示し、タイマーを追加し、ユーザーが間違ったパスワードを入力した後、[ サインイン ] ボタンをクリックまたはタップした場合に、入力テキスト コントロールを一定期間無効にします。

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

色のコントラスト

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

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

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

キーボードのサポート

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