UiaEventCallback コールバック関数 (uiautomationcoreapi.h)

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

 

クライアントがサブスクライブしたイベントが発生したときに UI オートメーションによって呼び出されるクライアント実装関数。

構文

UiaEventCallback Uiaeventcallback;

void Uiaeventcallback(
  [in] UiaEventArgs *pArgs,
  [in] SAFEARRAY *pRequestedData,
  [in] BSTR pTreeStructure
)
{...}

パラメーター

[in] pArgs

種類: UiaEventArgs*

イベント引数を含む UiaEventArgs 構造体のアドレス。

[in] pRequestedData

種類: SAFEARRAY*

イベントに関連付けられたデータを含む SAFEARRAY 。

[in] pTreeStructure

種類: BSTR

イベントがノードのセットに関連付けられている場合、イベントに関連付けられたツリーの構造を含む文字列。 「解説」を参照してください。

戻り値

なし

解説

この関数は、 UiaAddEvent と UiaRemoveEvent に渡されます。

ツリー構造は、すべての文字が "p" または ")" である文字列によって記述されます。 文字列の最初の文字は常にルート ノードを表します。 関数から要素が返されない場合、文字列は NULL です 。

"p" はノード (UI オートメーション要素) を表します。 1 つの "p" が別のノードに直接続くと、2 番目のノードは最初のノードの子になります。 ")" は、ツリーをバックアップするステップを表します。 たとえば、"pp)p" はノードを表し、その後に互いの兄弟である 2 つの子ノードが続きます。 "pp))p" では、最後のノードは最初のノードの兄弟です。

要件

サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	uiautomationcoreapi.h