「テキストを取得」アクティビティのご紹介をします。
1.アクティビティのプログラム名
RCA.Activities.Windows.GetText
2.説明
Studio バージョン 2.0.2.0まで
クイックアクセス： 「ツールボックス」 > 「ウィンドウアプリケーション」 > 「テキストを取得」
Studio バージョン 2.0.3.0から
クイックアクセス： 「ツールボックス」 > 「ウィンドウアプリケーション」 > 「テキストを取得」
ウィンドウアプリケーションで指定したアプリ内の指定した要素のテキストを取得します。
※動作を確認したコボットStudioのバージョン：2.1.1.2
※バージョンによって文言などが一部異なる場合がございます
3.プロパティ
| プロパティ項目 | プロパティ名 | 入力欄 | 説明 |
|---|---|---|---|
| オプション | From | 値を入力（UiElement型） | セレクタ文字列を持つ要素を検索する際に、UiElement変数をルートにする (設定されていない場合は、デスクトップのルートから探す) |
| オートメーションベース | ドロップダウン選択 | UI自動化ライブラリのバージョンを指定 | |
| 使用ウィンドウ | 値を入力（WindowApp型） | 「ウィンドウを開く」や「ウィンドウにアタッチ」からの出力変数を使用して、アクティビティの対象ウィンドウを設定 | |
| 要素 | 値を入力（AutomationElement型） | セレクタ文字列の代わりに、入力としてAutomationElement型の変数を使用 | |
| その他 | パブリック | チェック項目 | ログにアクティビティ内の変数と引数がログファイルに書き込まれ、Centerにプッシュされる。（詳細は「プロパティ項目「パブリック」について」を参照） |
| 表示名 | 任意の文字列 | デザイナーパネルのアクティビティ名に反映される。 | |
| 一般 | エラー時に続行 | 値を入力（Boolean型） | エラー時に後続の処理に進む |
| タイムアウト | 値を入力（Int32型） | エラーになる前に指定した時間（ミリ秒）待機 | |
| 実行後の待機時間 | 値を入力（Int32型） | 文字入力実行後に指定した時間（ミリ秒）待機する | |
| 実行前の待機時間 | 値を入力（Int32型） | 文字入力実行前に指定した時間（ミリ秒）待機する | |
| 出力 | 出力テキスト | 値を入力（String型） | 取得したテキストを格納する |
| 待機 | 消えるまで待機 | チェック項目 | UIが消えるまで待機 |
| 無効になるまで待機 | チェック項目 | UIが無効になるまで待機 | |
| 有効になるまで待機 | チェック項目 | UIが有効になるまで待機 | |
| 入力 | セレクタ | 値を入力（String型） | 対象要素を指定でクリックしたUI要素の詳細が反映される |
4.使い方
「テキストを取得」の使い方をアクティビティの使用例を参考に説明します。
【例】メモ帳で開いた任意ファイルの文字を取得する
今回使用するファイルには、以下の画像のように「テストデータ」というテキストが記載されています。
この「テストデータ」というテキストを取得します。
「ウィンドウを開く」で今回使用したいファイルをメモ帳で開く設定をします。
その後、「ウィンドウを開く」アクティビティの中の「実行」シーケンスの中に、「テキストを取得」アクティビティを配置します。
「テキストを取得」アクティビティ内の「要素を指定」から画面を進め、文字を取得したいフィールドを選択します。要素の選択方法は「セレクタの取得方法」をご覧ください。要素を指定後は、「セレクタ」プロパティに値が入ります。
※今回は、メモ帳に入力されている文章を取得したいので、文字入力をするエリアを要素指定します
取得した要素の内容を後で確認するために、「出力＞出力テキスト」プロパティにString変数「text」を指定します。変数の作成方法は「変数の作成」を参照ください。
「メッセージボックス」アクティビティを「テキストを取得」アクティビティの下に配置し、テキストに変数textを設定します。
「ホーム > スタート」をクリック、または、「F5キー」押下で実行します。実行すると指定したファイルがメモ帳が開いてから、ファイル内のテキスト「テストデータ"がメッセージボックスに設定されて表示されます。
