IUIAutomationDragPattern::GetCurrentGrabbedItems 方法 (uiautomationclient.h)

擷取專案集合,代表使用者拖曳做為拖曳作業一部分的完整專案集。

語法

HRESULT GetCurrentGrabbedItems(
  [out, retval, optional] IUIAutomationElementArray **retVal
);

參數

[out, retval, optional] retVal

類型: IAutomationElementArray**

使用者正在拖曳的專案集合。 如果只拖曳單一專案,則此屬性為 Null 或空陣列。 預設值為空陣列。

傳回值

類型: HRESULT

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

備註

如果使用者正在拖曳多個專案,則專案會以具有一組相關聯抓取元素的單一主元素來表示。 主要專案會引發適當的事件,以避免有一組大量的重複事件。 用戶端可以查詢 GrabbedItems 屬性,以取得擷取專案的完整清單。

規格需求

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

另請參閱

IUIAutomationDragPattern