WebDDA イベント
Web データ駆動型アダプター (WebDDA) は、オートメーションで使用できる一連のイベントを提供します。 イベントはページ イベントとコントロール イベントに分けることができます。 DOMで使用されているのと同じイベント名にマップされます。 イベントの詳細については、「イベント」を参照してください。
ページ イベントのアクションを登録するとき、RegisterActionForEvent(詳細については、HAT 自動化活動を使用してホストされたアプリケーションを自動化する を参照) 活動内のコントロール パラメーターは無視されます。 コントロール イベントの場合、ControlName パラメーターに、バインディングで指定されるコントロール名が含まれている必要があります。
一部のイベントは、イベントに関する追加のデータも提供します。 このデータには、GetActionData アクティビティを通じてアクセスできます。 (詳細については、 HAT 自動化活動を使用してホストされたアプリケーションを自動化する を参照) 次の例は、提供される形式を示しています。
<EventArgs[flags] [frame] [headers ] [navigationcontext] [postdata] [url] [urlcontext] [cancel] [type] [key][button]>
引数によってイベントに追加オプションが提供されます。
| 引数 | 説明 |
|---|---|
flags |
定数か、または BrowserNavConstants 列挙体で定義される値の組み合わせを指定する値。 |
frame |
リソースを表示するフレームの名前を結果として生み出す、大文字と小文字の区別のある文字列式。 指定されたフレームをリソースの対象にしない場合、これは NULL となります。 |
headers |
サーバーに送信する追加の HTTP ヘッダーを含む文字列。 これらのヘッダーは Web ブラウザーに追加されます。 URL が HTTP URL の場合、このパラメーターは無視されます。 |
navigationcontext |
新しいウィンドウを開くときに使用されるフラグ。 これらの値は、ポップアップ ウィンドウを表示する必要があるかどうかを決定するために使用されます。 |
postdata |
HTTPPOST トランザクションの一部として、サーバーに送信されるデータ。 POST トランザクションは、通常、HTML フォームによって収集されたデータの送信に使用されます。 このパラメーターが投稿データを指定しない場合は、このメソッドは HTTPGET トランザクションを発行します。 URL が HTTP URL でない場合、このパラメーターは無視されます。 |
url |
イベントの移動先となったページの URL。 |
urlcontext |
新しいウィンドウを開くページの URL。 このパラメータは、Web ブラウザーの NewWindow イベントの一部です。 |
cancel |
ページの作成がキャンセルされた (True) か、または終了しました (False)。 |
type |
通常、イベントの種類はイベント自身と同じです。 |
key |
イベントでクリックされたマウス ボタン ( 1= 左、2= 右など)。 |
button |
押されたボタンのコード (たとえば、Enter キーのコードは 13)。 |
コントロール イベント
コントロール イベントは、コントロールに関連付けられているイベントです。
次の表に、各パラメーターで使用できるコントロール イベントの一覧を示します。
| 要素 | 内容 |
|---|---|
| BeforeNavigate |
flags, frame, headers, navigationcontext, postdata, url |
| onblur | 種類 |
| onchange | 種類 |
| onclick | タイプ、ボタン |
| ondblclick | タイプ、ボタン |
| onfocus | 種類 |
| onkeydown | タイプ、キー |
| onmousedown | タイプ、ボタン |
| onreset | 種類 |
| onsubmit | 種類 |
ページ イベント
ページ イベントのアクションを登録すると、RegisterActionForEvent アクティビティのコントロール パラメーターは無視されます。 (詳細については、HAT 自動化活動を使用してホストされたアプリケーションを自動化する を参照してください)
次の表に、各パラメーターで使用できるページ イベントの一覧を示します。
| 要素 | 内容 |
|---|---|
| BeforeNavigate |
flags, frame, headers, navigationcontext, postdata, url |
| BeforeNewWindow |
flags, url, urlcontext |
| DocumentCompleted |
Notification, flag, url |
| DownloadStarted |
Notification, flag, url |
| DownloadCompleted |
Notification, flag, url |
| NewWindow2 | Cancel |
| NewWindow3 |
flags, url, urlcontext, cancel |