IUIAutomation6::AddEventHandlerGroup メソッド (uiautomationclient.h)

IUIAutomation6::CreateEventHandlerGroup で指定されたイベント ハンドラー メソッドのコレクションを登録します。

重要

Microsoft UI オートメーション クライアントは、さまざまな IUIAutomation インターフェイス名前空間で定義されている個々のイベント登録メソッドではなく、ハンドラー グループ メソッドを使用してイベント リスナーを登録する必要があります。

構文

HRESULT AddEventHandlerGroup(
  [in] IUIAutomationElement           *element,
       IUIAutomationEventHandlerGroup *handlerGroup
);

パラメーター

[in] element

イベント ハンドラー グループに関連付けられているUI オートメーション要素へのポインター。

handlerGroup

UI オートメーション イベント リスナーのコレクション。

戻り値

このメソッドは、成功すると S_OK を返します。 成功しなかった場合は、HRESULT エラー コードを返します。

解説

イベント ハンドラーを実装する前に、「スレッドの問題について」で説明されているスレッドの問題 について理解しておく必要があります。

イベントがイベントのサブスクライブ解除要求と同時に受信された場合、ハンドラーのサブスクライブ解除後にイベントがイベント ハンドラーに配信される可能性があります。 ベスト プラクティスは、コンポーネント オブジェクト モデル (COM) 標準に従い、参照カウントが 0 に達するまでイベント ハンドラー オブジェクトを破棄しないようにすることです。 イベントのサブスクライブを解除した直後にイベント ハンドラーを破棄すると、イベントが遅延して配信された場合、アクセス違反が発生する可能性があります。

要件

要件	値
サポートされている最小のクライアント	Windows 10 Version 1809 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server バージョン 1709 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	uiautomationclient.h (UIAutomation.h を含む)

こちらもご覧ください

IUIAutomation6::RemoveEventHandlerGroup、 IUIAutomation6 インターフェイス