「文字入力」アクティビティについてご紹介します。アクティビティの概要と使用例を参考に使い方をご説明します。
1.アクティビティのプログラム名
RCA.Activities.Windows.TypeInto
2.説明
Studio バージョン ~2.0.2.0
クイックアクセス： 「ツールボックス」 > 「ウィンドウアプリケーション」 > 「文字入力」
Studio バージョン 2.0.3.0~
クイックアクセス： 「ツールボックス」 > 「ウィンドウアプリケーション」 > 「文字入力」
ウィンドウアプリケーションの指定した場所に文字入力をします。
※動作を確認したコボットStudioのバージョン：2.0.1.6、2.1.0.0
※バージョンによって文言などが一部異なる場合がございます
3.プロパティ
| プロパティ項目 | プロパティ名 | 入力欄 | 説明 |
|---|---|---|---|
| オプション | From | 値を入力（UIElement型） | セレクタ文字列を持つ要素を検索する際に、UiElement変数をルートにします (設定されていない場合は、デスクトップのルートから探します) |
| Windows Messageを送る | チェック項目 | キーボード状態に依存しない入力が可能となる （日本語モードになっているときに日本語モードを無視して文字を入力する） | |
| オートメーションベース | プルダウン選択 | UI自動化ライブラリのバージョンを指定 | |
| キー入力後の遅延（ミリ秒） | 値を入力（Int32型） | 指定した時間（ミリ秒）だけキー入力に間隔を設ける | |
| 使用ウィンドウ | 値を入力（WindowApp型） | 「ウィンドウを開く」や「ウィンドウにアタッチ」からの出力変数を使用して、アクティビティの対象ウィンドウを設定します | |
| 要素 | 値を入力（AutomationElement型） | セレクタ文字列の代わりに、入力としてAutomationElement型の変数を使用します | |
| その他 | パブリック | チェック項目 | ログにアクティビティ内の変数と引数がログファイルに書き込まれ、Centerにプッシュされる。（詳細は「プロパティ項目「パブリック」について」を参照） |
| 表示名 | 任意の文字列 | デザイナーパネルのアクティビティ名に反映される。 | |
| 一般 | エラー時に続行 | 値を入力（Boolean型） | エラー時に後続の処理に進む |
| タイムアウト | 値を入力（Int32型） | エラーになる前に指定した時間（ミリ秒）待機 | |
| 実行後の待機時間 | 値を入力（Int32型） | 文字入力実行後に指定した時間（ミリ秒）待機する | |
| 実行前の待機時間 | 値を入力（Int32型） | 文字入力実行前に指定した時間（ミリ秒）待機する | |
| 待機 | 消えるまで待機 | チェック項目 | UIが消えるまで待機 |
| 無効になるまで待機 | チェック項目 | UIが無効になるまで待機 | |
| 有効になるまで待機 | チェック項目 | UIが有効になるまで待機 | |
| 入力 | セレクタ | 値を入力（String型） | 対象要素を指定でクリックしたUI要素の詳細が反映されます |
| テキスト | 値を入力（String型） | 記載したテキストが対象フィールドに書き込まれます。テキストは引用符で囲む必要があります。 | |
| 文字入力前の処理 | クリック | チェック項目 | 文字入力前に、入力フィールドをクリックします。 ※クリック・ダブルクリックのどちらか片方しか設定できません |
| ダブルクリック | チェック項目 | 文字入力前に、入力フィールドをダブルクリックします。 ※クリック・ダブルクリックのどちらか片方しか設定できません | |
| フィールド内を削除 | チェック項目 | 文字入力前に、入力フィールド内のテキストを削除します | |
| フォーカスを設定 | チェック項目 | 指定したUI要素にフォーカスする |
4.使い方
「文字入力」の使い方をアクティビティの使用例を参考に説明します。
【例】メモ帳に任意の文字を記載する
「ウィンドウを開く」でメモ帳を開く設定をします。
その後、「ウィンドウを開く」アクティビティの中の「実行」シーケンスの中に、「文字入力」アクティビティを配置します。
「文字入力」アクティビティ内の「要素を指定」から画面を進め、文字を入力したいフィールドを選択します。要素の選択方法は「セレクタの取得方法使い方」をご覧ください。要素を指定後は、「セレクタ」プロパティに値が入ります。
次に、下の画像のように入力したいテキストを入力フィールドに設定します。（今回の場合は「"kobot"」を入れます。）
また、「フィールド内を削除」プロパティのチェックを入れると、入力前に元々文字が入っていた場合に削除してから文字入力を行います。
「ホーム > スタート」をクリック、または、「F5キー」押下で実行します。実行するとメモ帳が開いてから、指定した文字が入力されます。
デザイナーパネル上の「＋」をクリックすると、enter（改行）などのキーを選択できます。
例えば「"kobot"」と入力後に「＋」から「enter」を選択し、さらに「kobot」をダブルクォーテーション内に追加し「"kobot[k(enter)]kobot"」とした場合、実行結果に改行を含めた文字が入ります。
