IUIAutomationDragPattern::GetCurrentGrabbedItems メソッド (uiautomationclient.h)

ユーザーがドラッグ操作の一部としてドラッグしている項目の完全なセットを表す要素のコレクションを取得します。

構文

HRESULT GetCurrentGrabbedItems(
  [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 を含む)

関連項目

IUIAutomationDragPattern