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