IUIAutomationElement::GetCachedChildren メソッド (uiautomationclient.h)

このUI オートメーション要素のキャッシュされた子要素を取得します。

構文

HRESULT GetCachedChildren(
  [out, retval] IUIAutomationElementArray **children
);

[out, retval] children

キャッシュされた子要素のコレクションへのポインターを受け取ります。

型: HRESULT

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

返されるコレクションのビューは、この要素が取得されたときにアクティブだった IUIAutomationCacheRequest の TreeFilter プロパティによって決まります。

子は、キャッシュ要求のスコープにTreeScope_Subtree、TreeScope_Children、またはTreeScope_Descendantsが含まれている場合にのみキャッシュされます。

キャッシュ要求で、子をこのレベルでキャッシュするように指定したが、子が存在しない場合、このプロパティの値は 0 になります。ただし、このレベルで子をキャッシュする要求が行われなかった場合、プロパティを取得しようとするとエラーが返されます。

要件	値
サポートされている最小のクライアント	Windows 7、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム、WINDOWS XP SP3 と 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 を含む)