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

説明

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

主要なプロパティ

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

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

その他のプロパティ

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

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

BorderStyle – コントロールの境界線を Solid (実線)、Dashed (破線)、Dotted (点線)、None (なし) のいずれに指定します。

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

FocusedBorderThickness – キーボードでフォーカスした場合のコントロールの境界線の太さです。

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

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

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

Disabled – コントロールをユーザーが操作できるかどうかを指定します。

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

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

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

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

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

FontWeight – コントロール内のテキストの太さです。Bold (太字)、Semibold (中太)、Normal (標準)、Lighter (細字) から指定します。

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

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

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

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

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

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

LineHeight – テキストの行間やリスト内の項目間などの距離です。

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

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

OnChange – ユーザーが (スライダーを調整するなどして) コントロールの値を変更した場合のアプリの反応を指定します。

OnSelect – ユーザーがコントロールをタップまたはクリックした場合のアプリの反応を指定します。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

TabIndex – ゼロ以外の値に設定すると、実行時のコントロールのタブの順序をカスタマイズできます。

Tooltip – ポインターをコントロールに合わせたときに表示される説明テキストです。

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

Visible – コントロールを表示するか非表示にするかを指定します。

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

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

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

関連する関数

DateTimeValue( String )

データの収集

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

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

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

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

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

  4. (省略可能) テンプレート ギャラリーで、下部の Body1 というテキスト ボックスを削除し、ギャラリーの TemplateSize プロパティを 80 に設定します。

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

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

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

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

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

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

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

    パスワードの入力が完了すると、テキスト ボックスの Access denied の表示が停止し、Access granted の表示が開始されます。

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

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

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