UiaAddEvent 関数 (uiautomationcoreapi.h)
構文
HRESULT UiaAddEvent(
[in] HUIANODE hnode,
[in] EVENTID eventId,
[in] UiaEventCallback *pCallback,
[in] TreeScope scope,
[in] PROPERTYID *pProperties,
[in] int cProperties,
[in] UiaCacheRequest *pRequest,
[out] HUIAEVENT *phEvent
);
パラメーター
[in] hnode
種類: HUIANODE
イベント リスナーを追加するノード。
[in] eventId
種類: EVENTID
リッスンするイベントの識別子。 イベント ID の一覧については、「 イベント識別子」を参照してください。
[in] pCallback
種類: UiaEventCallback*
イベントが発生したときに呼び出されるアプリケーション定義 UiaEventCallback コールバック関数のアドレス。
[in] scope
種類: TreeScope*
処理されるイベントのスコープを示す TreeScope 列挙型の値。つまり、要素自体上にあるか、先祖や子供の上にあるかです。
[in] pProperties
型: PROPERTYID*
eventId がAutomationPropertyChanged_Event_GUIDから派生した EVENTID である場合に、変更イベントを監視するプロパティの識別子を含む配列のアドレス。それ以外の場合、このパラメーターは NULL です。 プロパティ ID の一覧については、「 プロパティ識別子」を参照してください。
[in] cProperties
型: int
pProperties 配列内の要素の数。
[in] pRequest
型: UiaCacheRequest*
イベントで返されるノードに対して有効なキャッシュ要求を定義する UiaCacheRequest 構造体のアドレス。
[out] phEvent
種類: HUIEVENT*
この関数が戻るとき、 には、追加されるイベントへのポインターが含まれます。 このパラメーターは初期化せずに渡されます。
戻り値
種類: HRESULT
成功した場合はS_OKを返し、それ以外の場合はエラー値を返します。
要件
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | uiautomationcoreapi.h |
| Library | Uiautomationcore.lib |
| [DLL] | Uiautomationcore.dll |