IUIAutomation4

COM

IID1189c02a-05f8-4319-8e21-e817e3db2860継承元IUIAutomation3自前メソッド開始 vtbl66

公式ドキュメント

IUIAutomation3 インターフェイスを拡張し、Microsoft UI Automation の機能を制御するための追加メソッドを公開します。

メソッド 2

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 66 HRESULT AddChangesEventHandler(IUIAutomationElement* element, TreeScope scope, INT* changeTypes, INT changesCount, IUIAutomationCacheRequest* pCacheRequest, IUIAutomationChangesEventHandler* handler)

変更イベントを処理するメソッドを登録します。メモイベントハンドラーを実装する前に、Understanding Threading Issues で説明されているスレッド関連の問題について理解しておく必要があります。

element	IUIAutomationElement*	in	イベントハンドラーに関連付けられた UI Automation 要素へのポインター。
scope	TreeScope	in	処理するイベントのスコープ。つまり、イベントが要素自体に対するものか、その先祖および子孫に対するものかを指定します。
changeTypes	INT*	in	イベントが表す変更の種類を示す整数のリストへのポインター。
changesCount	INT	in	このイベントで発生した変更の数。
pCacheRequest	IUIAutomationCacheRequest*	in	キャッシュ要求へのポインター。キャッシュが不要な場合は NULL。
handler	IUIAutomationChangesEventHandler*	in	変更イベントを処理するオブジェクトへのポインター。

戻り値

Type: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

Microsoft UI Automation クライアントは、イベントハンドラーの追加や削除に複数のスレッドを使用すべきではありません。同一クライアントプロセス内で、あるイベントハンドラーの追加または削除中に別のイベントハンドラーの追加または削除が行われると、予期しない動作が発生する可能性があります。

vtbl 67 HRESULT RemoveChangesEventHandler(IUIAutomationElement* element, IUIAutomationChangesEventHandler* handler)

変更イベントハンドラーを削除します。

element	IUIAutomationElement*	in	ハンドラーを削除する対象の UI Automation 要素へのポインター。
handler	IUIAutomationChangesEventHandler*	in	AddChangesEventHandler に渡されたインターフェイスへのポインター。

戻り値

Type: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_IUIAutomation4 "{1189C02A-05F8-4319-8E21-E817E3DB2860}"
#usecom global IUIAutomation4 IID_IUIAutomation4 "{}"
#comfunc global IUIAutomation4_AddChangesEventHandler     66 sptr,int,var,int,sptr,sptr
#comfunc global IUIAutomation4_RemoveChangesEventHandler  67 sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IUIAutomation4 "{1189C02A-05F8-4319-8E21-E817E3DB2860}"
#usecom global IUIAutomation4 IID_IUIAutomation4 "{}"
#comfunc global IUIAutomation4_AddChangesEventHandler     66 sptr,int,sptr,int,sptr,sptr
#comfunc global IUIAutomation4_RemoveChangesEventHandler  67 sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。