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) |