IUIAutomationTreeWalker::GetFirstChildElementBuildCache メソッド (uiautomationclient.h)

指定した UI オートメーション要素の最初の子要素を取得し、プロパティとコントロール パターンをキャッシュします。

構文

HRESULT GetFirstChildElementBuildCache(
  [in]          IUIAutomationElement      *element,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **first
);

パラメーター

[in] element

種類: IUIAutomationElement*

最初の子を取得する対象の要素へのポインター。

[in] cacheRequest

種類: IUIAutomationCacheRequest*

返される要素にキャッシュするプロパティとコントロール パターンを指定するキャッシュ要求へのポインター。

[out, retval] first

種類: IUIAutomationElement**

最初の子要素へのポインターを受け取ります。子要素がない場合は NULL を 受け取ります。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

要素には、現在のビュー条件に一致しない追加の子要素を含めることができるため、要素ツリー内を移動しても返されません。

デスクトップ上の表示 UI 要素が変更されると、Microsoft UI オートメーション ツリーの構造が変更されます。 最初の子要素として返された要素が、後続のパスの最初の子として返されることは保証されません。

要件

サポートされている最小のクライアント	Windows 7、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム、SP3 を使用した Windows XP、Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム、WINDOWS Server 2003 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	uiautomationclient.h (UIAutomation.h を含む)