任意の文字列がディスプレイ端末の画面に表示されるのを待機します。
文字表示をトリガとしたホストとの対話処理を行う際に有効です。
待機文字列を発見した場合には、その発見位置をプロパティに格納します。
アプリケーションは文字列と共に表示位置を確認することもできます。
■待機文字列の発見位置FoundTextRow、FoundTextColumnプロパティ
構文 | object. FoundTextRow |
object. FoundTextColumn | |
データ型 | 整数 |
アクセス方法 | 参照（「WaitText（文字列表示待機）」メソッドの呼び出し後に有効） |
初期値 | 0 |
対象エミュレータ |
|
「WaitText（文字列表示待機）」メソッドが文字列を発見した場合、文字列の表示位置を行、桁で表します。
「WaitText（文字列表示待機）」メソッドが文字列を発見できなかった場合、値は0となります。
値は参照のみ可能であり、「WaitText（文字列表示待機）」メソッドの呼び出し後に有効となります。
構文 | object. WaitText( string | ||
引数 | 引数は次のものです。 | ||
項目 | 型 | 内容 | |
string | 文字列 | 表示を待機する文字列を1～1920の範囲で指定します。 | |
time | 整数 | 待機時間（秒単位）を-1、0～65535の範囲で指定します。 | |
row1 | 整数 | 表示を待機する矩形範囲の開始行位置を指定します。 | |
column1 | 整数 | 表示を待機する矩形範囲の開始桁位置を指定します。 | |
row2 | 整数 | 表示を待機する矩形範囲の終了行位置を指定します。 | |
column2 | 整数 | 表示を待機する矩形範囲の終了桁位置を指定します。 | |
二重発行動作 | キャンセル | ||
復帰値 | 0:正常/その他の値:異常 | ||
対象エミュレータ |
| ||
関連プロパティ | DspCodeConvType,FoundTextRow,FoundTextColumn,DspemuRow, DspemuColumn | ||
引数「time」で指定した時間の間、ディスプレイ端末に引数「string」で指定する文字列が表示されるのを待機します。
-1を指定した場合には無限待ちします。
0を指定した場合にはメソッド発行時の通信状態を確認して即時復帰します。
省略時には0が指定されたものとします。
引数「string」で指定する文字列を発見するか（すでに表示されていた場合も含む）、引数「time」で指定した待機時間が経過した時点でメソッドの処理は完了します。
文字列の待機は引数「row1、column1、row2、column2」で指定する矩形内で行います。
「row1、column1」は合わせて省略が可能です。省略された場合には、1行１桁目を開始位置とします。
「row2、column2」は合わせて省略が可能です。省略された場合には、最終行、最終桁を終了位置とします。
矩形の指定有効範囲は１行、１桁から「DspemuRow、DspemuColumn（画面サイズ・行、桁）」プロパティが表すディスプレイ端末の最大行、桁までとなります。
開始、終了位置は複写/貼り付けのメソッドと同様に正規化が行われます。
待機文字列を発見した場合には文字列の先頭位置を「FoundTextRow、FoundTextColumn（待機文字列の表示位置）」プロパティへ格納します。
引数「string」で指定する文字列中の1バイト文字は、「DspCodeConvType（1バイトコード変換種別）」プロパティで指定する変換種別でコード変換を行います。
LU切り替え操作により待機文字列が表示された場合も、メソッドは正常終了します。
