IUIAutomation::GetRootElement メソッド (uiautomationclient.h)
デスクトップを表すUI オートメーション要素を取得します。
構文
HRESULT GetRootElement(
[out, retval] IUIAutomationElement **root
);
パラメーター
[out, retval] root
種類: IUIAutomationElement**
UI オートメーション要素へのポインターを受け取ります。
戻り値
型: HRESULT
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
注釈
ルート要素は、 FindAll メソッドと FindFirst メソッドを使用して、他の要素を検索するための開始点として使用できます。
ルート要素から検索する場合は、TreeScope_Descendantsではなく、検索のスコープでTreeScope_Childrenを指定してください。 デスクトップのサブツリー全体を検索すると、何千もの項目が反復処理され、スタック オーバーフローが発生する可能性があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | 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 を含む) |