Метод IDragProvider::GetGrabbedItems (uiautomationcore.h)

  • Статья

Извлекает коллекцию элементов, которые перетаскиваются в рамках операции перетаскивания.

Синтаксис

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

Параметры

[out, retval, optional] pRetVal

Массив VT_UNKNOWN указателей на интерфейсы IRawElementProviderSimple перетаскиваемых элементов. Этот параметр имеет значение NULL , если перетаскивается только один элемент.

Возвращаемое значение

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Если пользователь перетаскивает несколько элементов, элементы представляются одним элементом master со связанным набором перехватанных элементов. Элемент master вызывает соответствующие события, чтобы избежать большого набора повторяющихся событий. Клиент может вызвать GetGrabbedItems , чтобы получить полный список перехватанных элементов. Поставщик должен выделить SAFEARRAY соответствующей длины и добавить указатели com для элементов, которые являются частью операции перетаскивания.

Требования

Требование Значение
Минимальная версия клиента Windows 8 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header uiautomationcore.h (включая UIAutomation.h)

См. также раздел

IDragProvider