Метод IUIAutomationDragPattern::GetCachedGrabbedItems (uiautomationclient.h)
Извлекает кэшированную коллекцию элементов, представляющих полный набор элементов, которые пользователь перетаскивает в рамках операции перетаскивания.
Синтаксис
HRESULT GetCachedGrabbedItems(
[out, retval, optional] IUIAutomationElementArray **retVal
);
Параметры
[out, retval, optional] retVal
Тип: IAutomationElementArray**
Кэшированная коллекция элементов, перетаскиваемых пользователем. Это свойство имеет значение NULL или пустой массив, если перетаскивается только один элемент. Значением по умолчанию является пустой массив.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Если пользователь перетаскивает несколько элементов, элементы представляются одним элементом master со связанным набором перехватанных элементов. Элемент master запускает соответствующие события, чтобы избежать большого набора повторяющихся событий. Клиент может запросить свойство GrabbedItems, чтобы получить полный список перехватанных элементов.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Целевая платформа | Windows |
| Header | uiautomationclient.h (включая UIAutomation.h) |