PowerApps のテキスト入力コントロールText input control in PowerApps

ユーザーがテキスト、数値、およびその他のデータを入力できるボックス。A box in which the user can type text, numbers, and other data.

説明Description

ユーザーは、テキスト入力コントロールに入力してデータを指定できます。The user can specify data by typing into a text-input control. アプリの構成方法に応じて、そのデータをデータ ソースに追加したり、一時的な値を計算するために使用したり、他の方法で組み込んだりすることができます。Depending on how you configure the app, that data might be added to a data source, used to calculate a temporary value, or incorporated in some other way.

主要なプロパティKey properties

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

Text – コントロールに表示されるテキスト、またはコントロールにユーザーが入力するテキストです。Text – Text that appears on a control or that the user types into a control.

その他のプロパティAdditional properties

Align – コントロールの水平方向の中心に対するテキストの位置です。Align – The location of text in relation to the horizontal center of its control.

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.

Clear – テキスト入力コントロールに、ユーザーがタップまたはクリックして、そのコントロールの内容をクリアできる "X" を表示するかどうかを指定します。Clear – Whether a text-input control shows an "X" that the user can tap or click to clear the contents of that control.

Color – コントロールのテキストの色です。Color – The color of text in a control.

DelayOutput – true に設定した場合、1/2 秒の遅延の後、ユーザー入力が登録されます。DelayOutput – When set to true, user input is registered after half a second delay. 負荷のかかる操作をユーザーがテキストの入力を完了するまで遅らせる場合 (つまり入力が他の数式で使用される際にフィルタ処理する場合) に便利です。Useful for delaying expensive operations until user completes inputting text (i.e. for filtering when input is used in other formulas).

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.

DisabledColor – コントロールの DisplayMode プロパティが Disabled に設定されている場合のコントロール内のテキストの色です。DisabledColor – The color of text in a control if its DisplayMode property is set to Disabled.

DisabledFill – コントロールの DisplayMode プロパティが Disabled に設定されている場合のコントロールの背景色です。DisabledFill – The background color of a control if its DisplayMode property is set to Disabled.

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

Font – テキストを表記するフォントのファミリー名です。Font – The name of the family of fonts in which text appears.

FontWeight – コントロール内のテキストの太さです。Bold (太字)、Semibold (中太)、Normal (標準)、Lighter (細字) から指定します。FontWeight – The weight of the text in a control: Bold, Semibold, Normal, or Lighter.

Format – ユーザー入力を数字のみに制限するか、すべてのテキストを許可するかを指定します。Format – Whether the user input is restricted to numbers only or can be any text.

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

HintText - テキスト入力コントロールが空の場合に表示される薄いグレーのテキストです。HintText – Light-grey text that appears in an input-text control if it's empty.

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

HoverColor – コントロールにユーザーがマウス ポインターを重ねているときのコントロール内のテキストの色です。HoverColor – The color of the text in a control when the user keeps the mouse pointer on it.

HoverFill – コントロールにユーザーがマウス ポインターを重ねているときのコントロールの背景色です。HoverFill – The background color of a control when the user keeps the mouse pointer on it.

Italic – コントロール内のテキストを斜体にするかどうかを指定します。Italic – Whether the text in a control is italic.

LineHeight – テキストの行間やリスト内の項目間などの距離です。LineHeight – The distance between, for example, lines of text or items in a list.

MaxLength – ユーザーがテキスト入力コントロールに入力できる文字数です。MaxLength – The number of characters that the user can type into a text-input control.

Mode – コントロールのモードは、SingleLineMultiLine、または Password です。Mode – The control is in SingleLine, MultiLine, or Password mode.

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

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

PaddingBottom – コントロール内のテキストとそのコントロールの下端間の距離です。PaddingBottom – The distance between text in a control and the bottom edge of that control.

PaddingLeft – コントロール内のテキストとそのコントロールの左端間の距離です。PaddingLeft – The distance between text in a control and the left edge of that control.

PaddingRight – コントロール内のテキストとそのコントロールの右端間の距離です。PaddingRight – The distance between text in a control and the right edge of that control.

PaddingTop – コントロール内のテキストとそのコントロールの上端間の距離です。PaddingTop – The distance between text in a control and the top edge of that control.

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

PressedColor – コントロールをユーザーがタップまたはクリックしたときのコントロール内のテキストの色です。PressedColor – The color of text in a control when the user taps or clicks that control.

PressedFill – コントロールをユーザーがタップまたはクリックしたときのコントロールの背景色です。PressedFill – The background color of a control when the user taps or clicks that control.

RadiusBottomLeft – コントロールの左下隅を丸める度合いです。RadiusBottomLeft – The degree to which the bottom-left corner of a control is rounded.

RadiusBottomRight – コントロールの右下隅を丸める度合いです。RadiusBottomRight – The degree to which the bottom-right corner of a control is rounded.

RadiusTopLeft – コントロールの左上隅を丸める度合いです。RadiusTopLeft – The degree to which the top-left corner of a control is rounded.

RadiusTopRight – コントロールの右上隅を丸める度合いです。RadiusTopRight – The degree to which the top-right corner of a control is rounded.

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

Size – コントロールに表示されるテキストのフォント サイズです。Size – The font size of the text that appears on a control.

Strikethrough – コントロールに表示されるテキストに取り消し線を付けるかどうかを指定します。Strikethrough – Whether a line appears through the text that appears on a control.

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

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

Underline – コントロールに表示されるテキストの下に線を引くかどうかを指定します。Underline – Whether a line appears under the text that appears on a 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).

DateTimeValue( String )DateTimeValue( String )

Examples

データの収集Collect data

  1. 2 つのテキスト入力コントロールを追加し、それらに inputFirstinputLast という名前を付けます。Add two text-input controls, and name them inputFirst and inputLast.

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

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

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

  3. 縦/垂直方向にテキスト ギャラリーを追加し、その Items プロパティを Names に設定し、Subtitle1Text プロパティを ThisItem.FirstName に設定します。Add a text gallery in portrait/vertical orientation, set its Items property to Names, and set the Text property of Subtitle1 to ThisItem.FirstName.
  4. (省略可能) テンプレート ギャラリーで、下部の Body1 というラベルを削除し、ギャラリーの TemplateSize プロパティを 80 に設定します。(optional) In the template gallery, delete the bottom label, named Body1, and set the TemplateSize property of the gallery to 80.
  5. F5 キーを押して、inputFirstinputLast に文字列を入力して、[追加] ボタンをクリックまたはタップします。Press F5, type a string of text into inputFirst and inputLast, and then click or tap the Add button.
  6. (省略可能) 他の名前をコレクションに追加し、Esc キーを押して、既定のワークスペースに戻ります。(optional) Add more names to the collection, and then press Esc to return to the default workspace.

パスワードの入力を求めるPrompt for a password

  1. テキスト入力コントロールを追加し、それに inputPassword という名前を付けて、その Mode プロパティを Password に設定します。Add a text-input control, name it inputPassword, and set its Mode property to Password.
  2. ラベルを追加し、その Text プロパティを次の数式に設定します。Add a label, and set its Text property to this formula:
    If(inputPassword.Text = "P@ssw0rd", "Access granted", "Access denied")If(inputPassword.Text = "P@ssw0rd", "Access granted", "Access denied")

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

  3. F5 キーを押し、inputPasswordP@ssw0rd と入力します。Press F5, and then type P@ssw0rd in inputPassword.

    パスワードの入力が完了すると、ラベルの Access denied の表示が停止し、Access granted の表示が開始されます。When you finish typing the password, the label stops showing Access denied and starts to show Access granted.

  4. 既定のワークスペースに戻るには、Esc キーを押します。To return to the default workspace, press Esc.
  5. (省略可能) 矢印などのコントロールを追加し、それを別の画面に移動するように構成し、ユーザーがパスワードを入力した後にのみ表示します。(optional) Add a control such as an arrow, configure it to navigate to another screen, and show it only after the user types the password.
  6. (省略可能) ボタンを追加し、その Text プロパティに Sign in と表示されるように設定し、タイマーを追加して、ユーザーが間違ったパスワードを入力して、[Sign in] ボタンをクリックまたはタップした場合に、一定の時間テキスト入力コントロールを無効にします。(optional) Add a button, configure its Text property to show Sign in, add a timer, and disable the input-text control for a certain amount of time if the user types the wrong password and then clicks or taps the Sign in button.