IUIAutomationDragPattern::GetCachedGrabbedItems メソッド (uiautomationclient.h)
ユーザーがドラッグ操作の一部としてドラッグしている項目の完全なセットを表す、キャッシュされた要素のコレクションを取得します。
構文
HRESULT GetCachedGrabbedItems(
[out, retval, optional] IUIAutomationElementArray **retVal
);
パラメーター
[out, retval, optional] retVal
種類: IAutomationElementArray**
ユーザーがドラッグしている要素のキャッシュされたコレクション。 1 つの項目のみがドラッグされている場合、このプロパティは NULL または空の配列です。 既定値は空の配列です。
戻り値
種類: HRESULT
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
注釈
ユーザーが複数のアイテムをドラッグしている場合、アイテムは、関連付けられた一連のグラブ要素を持つ 1 つのマスター要素によって表されます。 マスター アイテムは、重複するイベントの大規模なセットを避けるために、適切なイベントを発生させます。 クライアントは、GrabbedItems プロパティに対してクエリを実行して、グラブされたアイテムの完全な一覧を取得できます。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | uiautomationclient.h (UIAutomation.h を含む) |