IDragProvider::GetGrabbedItems 方法 (uiautomationcore.h)

擷取正在拖曳為拖曳作業一部分的專案集合。

語法

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

參數

[out, retval, optional] pRetVal

要拖曳之元素 之 IRawElementProviderSimple 介面的VT_UNKNOWN指標數組。 如果只拖曳單一專案,則此參數為 NULL

傳回值

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

如果使用者正在拖曳多個專案,則專案會以具有一組相關聯抓取元素的單一主元素來表示。 master 元素會引發適當的事件,以避免有一組大量的重複事件。 用戶端可以呼叫 GetGrabbedItems 來擷取已抓取專案的完整清單。 提供者應該配置適當長度的 SAFEARRAY ,並將元件物件模型 (COM) 屬於拖曳作業一部分的項目指標。

規格需求

需求
最低支援的用戶端 Windows 8 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2012 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 uiautomationcore.h (包含 UIAutomation.h)

另請參閱

IDragProvider