UiaAddEvent 関数 (uiautomationcoreapi.h)

  • [アーティクル]
メモ この関数は非推奨です。 クライアント アプリケーションでは、代わりに Microsoft UI オートメーション コンポーネント オブジェクト モデル (COM) インターフェイスを使用する必要があります。
 
UI オートメーション ツリーのノード上のイベントのリスナーを追加します。

構文

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

関連項目

UiaLookupId