文字を入力

テキスト ボックスなどの指定した UI 要素にテキストを入力します。Tab や Enter などの特殊キーを UI 要素に送信することもできます。

機密情報を安全に入力するには、この API の前に GetCredential API を追加して、その API で取得し、後で使用するために保存したユーザー名とパスワードの値を、入力するテキストとして選択します。

この API は Open または Attach の後に追加する必要があります。

定義

名前空間: UiPath.UIAutomationNext.API.Models

アセンブリ: UiPath.UIAutomationNext.API.Models (in UiPath.UIAutomationNext.API.Models dll)

オーバー ロード

オーバーロード	説明
TypeInto(TargetAnchorableModel, String)	オブジェクト リポジトリで文字列として識別された特定の UI 要素にテキストを入力します。
TypeInto(TargetAnchorableModel, TypeIntoOptions)	TargetAnchorableModel オブジェクトとして識別された特定の UI 要素にテキストを入力します。
TypeInto(String, String)	オブジェクト リポジトリで文字列として識別された特定の UI 要素にテキストを入力します。
TypeInto(String, TypeIntoOptions)	オブジェクト リポジトリで文字列として識別された特定の UI 要素にテキストを入力します。同時に、その他の設定も行います。

TypeInto(TargetAnchorableModel, String)

オブジェクト リポジトリで文字列として識別された特定の UI 要素にテキストを入力します。

TypeInto(
    TargetAnchorableModel target,
    string text)

target TargetAnchorableModel : ターゲット UI 要素。TargetAnchorableModel オブジェクトとして識別されます。

text文字列 : 入力するテキスト。

TypeInto(TargetAnchorableModel, TypeIntoOptions)

TargetAnchorableModel オブジェクトとして識別された特定の UI 要素にテキストを入力します。

TypeInto(
    TargetAnchorableModel target,
    TypeIntoOptions typeIntoOptions)

target TargetAnchorableModel : ターゲット UI 要素。TargetAnchorableModel オブジェクトとして識別されます。

typeIntoOptions TypeIntoOptions : 次のオプションが利用できます。

* `Text
  String` - The text that you want to type into.
* `DelayBetweenKeys Double` - Delay (in
  seconds) between consecutive keystrokes. The default value is 0.02
  seconds.
* `ActivateBefore Boolean` - If true,
  the specified UI element is brought to the foreground and activated
  before the text is typed in. If false, the API will type into the
  current active window.
* `ClickBeforeMode NClickMode` - the
  type of click to perform before typing into:
  + `None`
  + `Single`
  + `Double`
* `EmptyFieldMode NEmptyFieldMode` -
  Choose whether to delete the existing content in the field
  before typing the text, and how to empty the field. Fields are
  emptied by sending a combination of keystrokes that differs
  between fields with a single line and fields with multiple
  lines. Make sure to select the right option depending on the
  indicated field. The options are:
  + `None`
  + `SingleLine`
  + `MultiLine`
* `DeselectAfter Boolean` - This can
  only be used when the `InteractionMode` is set to
   `Simulate`. Some target applications do not
  register a type action unless a Complete event is also sent
  alongside the action. Setting this to true adds a Complete event
  after the text entry, in order to register the action correctly. If
  you set it to false, the Complete event is not sent to the target
  application. By default, this is set to true.
* `AlterIfDisabled Boolean` - If set to
  true, the Select Item action is executed even if the specified UI
  element is disabled. This parameter does not apply if the
  `InteractionMode` is set to `Hardware
  Events`. By default, this is false.
* `InteractionMode
  NChildInteractionMode` - Specifies the API used to
  perform the action. The following options are available:
  + `SameAsCard` - Use the same input mode
    as [Open](https://docs.uipath.com/activities/other/latest/ui-automation/uipath-uiautomationnext-api-contracts-iuiautomationappservice-open) or [Attach](https://docs.uipath.com/activities/other/latest/ui-automation/uipath-uiautomationnext-api-contracts-iuiautomationappservice-attach). This is the default selection.
  + `HardwareEvents` - Uses the hardware
    driver to perform the action. This is the slowest API, it
    cannot work in the background, but it is compatible with all
    desktop apps.
  + `Simulate` - Simulates the action using
    accessibility APIs. Recommended in browser automation, Java
    apps, or SAP. More reliable than Hardware Events. Sends all
    text in a single action. Works even if the target
    application is not in focus. Please test if your target
    application UI element supports this.
  + `DebuggerApi` - Performs actions using
    debugger APIs. Works for Chromium elements only. Sends all
    text in one go. Works even if the target application is not
    in focus. For more details, check out this [page](https://docs.uipath.com/studio/docs/chromium-api).
  + `WindowMessages` - Sends the mouse and
    keyboard input through Win32 messages. Recommended for
    desktop apps. Usually more reliable than Hardware Events.
    Sends all text in a single action. Works even if target app
    is not in focus. Please test if your target application UI
    element supports this.

TypeInto(String, String)

オブジェクト リポジトリで文字列として識別された特定の UI 要素にテキストを入力します。

TypeInto(
    string target,
    string text)

target : 入力先のターゲット UI 要素です。オブジェクト リポジトリで文字列として識別されます。

text文字列 : 入力するテキスト。

TypeInto(String, TypeIntoOptions)

オブジェクト リポジトリで文字列として識別された特定の UI 要素にテキストを入力します。同時に、その他の設定も行います。

TypeInto(
    string target,
    TypeIntoOptions typeIntoOptions)

target : 入力先のターゲット UI 要素です。オブジェクト リポジトリで文字列として識別されます。

typeIntoOptions TypeIntoOptions : 次のオプションが利用できます。

* `Text
  String` - The text that you want to type into.
* `DelayBetweenKeys Double` - Delay (in
  seconds) between consecutive keystrokes. The default value is 0.02
  seconds.
* `ActivateBefore Boolean` - If true,
  the specified UI element is brought to the foreground and activated
  before the text is typed in. If false, the API will type into the
  current active window.
* `ClickBeforeMode NClickMode` - the
  type of click to perform before typing into:
  + `None`
  + `Single`
  + `Double`
* `EmptyFieldMode NEmptyFieldMode` -
  Choose whether to delete the existing content in the field
  before typing the text, and how to empty the field. Fields are
  emptied by sending a combination of keystrokes that differs
  between fields with a single line and fields with multiple
  lines. Make sure to select the right option depending on the
  indicated field. The options are:
  + `None`
  + `SingleLine`
  + `MultiLine`
* `DeselectAfter Boolean` - This can
  only be used when the `InteractionMode` is set to
   `Simulate`. Some target applications do not
  register a type action unless a Complete event is also sent
  alongside the action. Setting this to true adds a Complete event
  after the text entry, in order to register the action correctly. If
  you set it to false, the Complete event is not sent to the target
  application. By default, this is set to true.
* `AlterIfDisabled Boolean` - If set to
  true, the Select Item action is executed even if the specified UI
  element is disabled. This parameter does not apply if the
  `InteractionMode` is set to `Hardware
  Events`. By default, this is false.
* `InteractionMode
  NChildInteractionMode` - Specifies the API used to
  perform the action. The following options are available:
  + `SameAsCard` - Use the same input mode
    as [Open](https://docs.uipath.com/activities/other/latest/ui-automation/uipath-uiautomationnext-api-contracts-iuiautomationappservice-open) or [Attach](https://docs.uipath.com/activities/other/latest/ui-automation/uipath-uiautomationnext-api-contracts-iuiautomationappservice-attach). This is the default selection.
  + `HardwareEvents` - Uses the hardware
    driver to perform the action. This is the slowest API, it
    cannot work in the background, but it is compatible with all
    desktop apps.
  + `Simulate` - Simulates the action using
    accessibility APIs. Recommended in browser automation, Java
    apps, or SAP. More reliable than Hardware Events. Sends all
    text in a single action. Works even if the target
    application is not in focus. Please test if your target
    application UI element supports this.
  + `DebuggerApi` - Performs actions using
    debugger APIs. Works for Chromium elements only. Sends all
    text in one go. Works even if the target application is not
    in focus. For more details, check out this [page](https://docs.uipath.com/studio/docs/chromium-api).
  + `WindowMessages` - Sends the mouse and
    keyboard input through Win32 messages. Recommended for
    desktop apps. Usually more reliable than Hardware Events.
    Sends all text in a single action. Works even if target app
    is not in focus. Please test if your target application UI
    element supports this.