IRawElementProviderAdviseEvents インターフェイス (uiautomationcore.h)

  • [アーティクル]

Microsoft UI オートメーション クライアント アプリケーションがそのフラグメントのイベントのリッスンを開始または終了したときにフラグメントのルート要素に通知するために呼び出されるメソッドを公開します。

継承

IRawElementProviderAdviseEvents インターフェイスは、IUnknown インターフェイスから継承されます。 IRawElementProviderAdviseEvents には、次の種類のメンバーもあります。

メソッド

IRawElementProviderAdviseEvents インターフェイスには、これらのメソッドがあります。

 
IRawElementProviderAdviseEvents::AdviseEventAdded

UI オートメーション クライアントがプロパティ変更イベントを含む特定のイベントのリッスンを開始したときに、Microsoft UI オートメーション プロバイダーに通知します。
IRawElementProviderAdviseEvents::AdviseEventRemoved

UI オートメーション クライアントがプロパティ変更イベントを含む特定のイベントのリッスンを停止したときに、Microsoft UI オートメーション プロバイダーに通知します。

注釈

このインターフェイスの実装は省略可能です。 イベントがリッスンされている場合にのみイベントを発生させることで、パフォーマンスを向上させるために使用できます。

コンポーネント オブジェクト モデル (COM) プログラミングでの参照カウントの実装と同様に、UI オートメーション プロバイダーは、IUnknown インターフェイスの AddRef メソッドや Release メソッドのような AdviseEventAdded メソッドと AdviseEventRemoved メソッドを処理することが重要です。 特定のイベントまたはプロパティに対して AdviseEventAdded が AdviseEventRemoved よりも多くの回数呼び出されている限り、一部のクライアントがまだリッスンしているため、プロバイダーは引き続き対応するイベントを発生させる必要があります。 または、UI オートメーション プロバイダーは、UiaClientsAreListening 関数を使用して、少なくとも 1 つのクライアントがリッスンしているかどうかを判断し、存在する場合は、すべての適切なイベントを発生させることができます。

要件

要件 値
サポートされている最小のクライアント Windows XP [デスクトップ アプリ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー uiautomationcore.h (UIAutomation.h を含む)