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