IDragProvider::GetGrabbedItems メソッド (uiautomationcore.h)

  • [アーティクル]

ドラッグ操作の一部としてドラッグされる要素のコレクションを取得します。

構文

HRESULT GetGrabbedItems(
  [out, retval, optional] SAFEARRAY **pRetVal
);

パラメーター

[out, retval, optional] pRetVal

ドラッグVT_UNKNOWN要素の IRawElementProviderSimple インターフェイスへのポインターの配列。 1 つの項目のみがドラッグされている場合、このパラメーターは NULL です 。

戻り値

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

注釈

ユーザーが複数のアイテムをドラッグしている場合、アイテムは、関連付けられた一連のグラブ要素を持つ 1 つのマスター要素によって表されます。 master 要素は、大量の重複イベントが発生しないように、適切なイベントを発生させます。 クライアントは GetGrabbedItems を 呼び出して、グラブされたアイテムの完全な一覧を取得できます。 プロバイダーは、適切な長さの SAFEARRAY を割り当て、ドラッグ操作の一部である要素のコンポーネント オブジェクト モデル (COM) ポインターを追加する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 8 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー uiautomationcore.h (UIAutomation.h を含む)

こちらもご覧ください

IDragProvider