画面レベルのメソッド

画面レベルのメソッドを使用して、エミュレーター画面で自動化タスクを実行します。たとえば、画面上でコマンドをシミュレートしたり、画面からテキストを取得したりできます。

GetFieldText

指定した行番号と列番号に基づいてフィールドを識別した後、フィールドに含まれるテキストを返します。指定した行と列がフィールドの開始点になります。このメソッドはフィールド全体を識別し、フィールド内のテキストを返します。次の例では、H はフィールドの最初の文字かつ開始点であり、Host OS : はフィールドのテキスト全文です。

GetTextFromRect

画面上で定義した矩形領域のすべてのフィールドのテキストを返します。矩形領域を指定するには、開始と終了の行番号と列番号を指定します。このメソッドは、最初と最後のフィールドを検索して識別し、その領域内のすべてのフィールドのすべてのテキストを返します。次の例は、指定した領域を示しています。

IsCreated

エミュレーター画面が画面一致ルールに基づいて存在しており、ユーザーからの入力を受け入れできるかどうかを検証します。検証後、このメソッドは適切なブール値を返します。

SearchText

SendKeys

エミュレーター画面上のマウスデバイスの位置でユーザーがキーボードから入力するキーストロークをシミュレートします。たとえば、画面上で [enter] のキーストロークをシミュレートすることができます。

SendKeysSecure

エミュレーター画面上のマウスデバイスの位置でセキュリティで保護された文字列のキーストロークをシミュレートします。

SetCursorPosition

指定した行番号と列番号にマウスデバイスを設定しようと試みます。

WaitForCreate

コネクタが画面一致ルールを使用して画面が存在するかどうかを調べる間、指定された期間待機します。

要素レベルのメソッド

要素レベルのメソッドは、[Terminal コネクタ (Terminal Connector)] 画面から追加したエミュレーター画面要素に対して自動化タスクを実行します。画面要素をフィールドまたはテーブルとして追加できます。

GetAsTable

データテーブルオブジェクトとしてキャプチャしたテキストを返します。画面からデータをテーブルとしてキャプチャする場合に、このメソッドを使用します。ただし、データをフィールドとしてキャプチャする場合にも、このメソッドを使用できます。テーブルとしてデータをキャプチャする方法については、「IBM Personal Communications エミュレーターの構成」を参照してください。

GetText

エミュレーター画面からキャプチャしたフィールドのテキストを返します。キャプチャしたテーブルに対してこのメソッドを使用すると、矩形の最初のフィールドのテキストが返されます。

IsCreated

ルールを照合し、キャプチャした要素が存在するかどうかを検証します。

SetText

フィールドへのテキストの設定を試みます。

WaitForCreate

コネクターが一致ルールを使用して要素が存在するかどうかを調べる間、指定された期間待機します。