ConnectHTML

このコマンドには、コンポーネント　“GuiXTコントロールズ”　”Viewer” が必要です。

Viewで現在表示されているHTMLページで[Continue]ボタンをクリックします。

ステートメントで指定されたものと同じ名前を使用します。

Control …. name=“myname”

Ÿ   connectHTML options window=“&V[viewwindow]”

“View …. returnwindow=viewwindow” ステートメントによって返されたウィンドウ番号を使用します。 すべてのオプションとHTML変数は、このウィンドウを参照します。

connectHTMLの後、HTML変数を使用できます。

Ÿ  Set html[name] “value” // HTMLページに値をセットします。

Ÿ  “… &html[name] …” // HTMLページから値を読み取ります。

Ÿ  if html[name]     // 　HTML要素の存在を問い合わせます。

Ÿ  Set html[name] “value” // HTMLページに値をセットします。

Ÿ  “… &html[name] …” // HTMLページから値を読み取ります。

Ÿ  if html[name]     // 　HTML要素の存在を問い合わせます。  

新しい値が設定されると、GuiXTはこの要素のHTMLページの「変更時」ルーチンを自動的に呼び出します。 ドロップダウンフィールド（要素の選択）の場合、場合によっては、この要素を変更した後、click =を使用してクリックする必要があります。 そうしないと、HTMLページの内部処理の一部が失われる可能性があります。

HTMLページのユーザー操作を自動化する場合、ほとんどの場合（値を設定してリンク、ボタン、または画像をクリックすること）、connectHTMLが提供する手段で十分です。 ただし、特別なJavaScriptまたはVBScript関数が使用されている場合や、ページに特別なプラグインが含まれている場合は、ユーザー操作の自動化がconnectHTML機能を超える場合があります。

GuiXTは次の方法で要素の名前を作成します。名前は常に要素タイプ（image_, button_, checkbox_, …）で始まります。 次に、要素の内部IDまたは名前、またはユーザーテキスト（ボタンテキストなど）。 すべての「スペース」文字は下線に置き換えられます。 重複する名前が発生した場合、GuiXTは接尾辞.2、.3、…を追加します。

例：

html[image_help.jpg]
html[link_Search]
html[link_Search.2]
html[select_Country]
html[text_Search_Filter]

例：

html[cell_1.4.5]

ぺージの最初のテーブル内のセル、つまり行4、カラム5（1から始まる）のセルを示します。

ネストされたテーブルの場合、名前はテーブルを含むセルの名前で始まり、その後に「〜」とネストされたテーブル内の通常のセル座標が続きます。

例：

html[cell_3_1_7~1_2_2~2.2.4]

これは次のセルです。ページの3番目の外部テーブルから始めます。行1、カラム7のセルを選択します。このセルには少なくとも1つのネストしたテーブルがあります。最初のネストされたテーブルの最初の1つを取得してから、行2、カラム2のセルを取得します。このセルには、少なくとも2つのネストされたテーブルがあります（ネストレベル2）。

2番目のものを取得し行2とカラム4に移動すると、セルcell_3_1_7~1_2_2~2.2.4に到達します。

各テーブルの行数

各テーブルに対して、GuiXTはこのテーブルの行数を含むHTML変数 “…_ rows”を割り当てます。

例：

“&html[table_1_rows]”
最初のテーブルの行数を示します。ネストした表には、上記と同じルールが適用されます。

例：

“&html[table_3_1_7~1_rows]”
これは、ページの3番目のテーブルのセル行1列7に含まれる最初のネストされたテーブルの行数です。

行カウントを使用する代わりに、特定のセルの存在を照会する方が多くの場合より現実的です。

例：

// row index
Set V[i] 1

label begin

// no further row?
if not html[cell_1.&V[i].1]
goto end
endif

… process table row

Set V[i] &V[i] + 1
goto begin

label end

例：

Set html[radio_English] 1

各connectHTML コマンドはまず、ページが完全に読み込まれるまで待機してから、必要なアクションを実行します。 2分間待機した後、connectHTMLはスクリプト処理に戻ります。下記を使用すると、connectHTMLの後で、アクションが成功したかどうかを照会できます。

if not Q[ok] Return “….”
endif