Интерфейс IUIAutomation (uiautomationclient.h)
Предоставляет методы, позволяющие клиентским приложениям Майкрософт модель автоматизации пользовательского интерфейса обнаруживать, получать доступ к элементам модель автоматизации пользовательского интерфейса и фильтровать их. модель автоматизации пользовательского интерфейса предоставляет каждый элемент модель автоматизации пользовательского интерфейса в виде объекта, представленного интерфейсом IUIAutomation. Члены этого интерфейса не относятся к конкретному элементу.
Наследование
Интерфейс IUIAutomation наследуется от интерфейса IUnknown . IUIAutomation также имеет следующие типы элементов:
Методы
Интерфейс IUIAutomation содержит следующие методы.
| IUIAutomation::AddAutomationEventHandler Регистрирует метод, обрабатывающий события Microsoft модель автоматизации пользовательского интерфейса. Примечание. Перед реализацией обработчика событий необходимо ознакомиться с проблемами потоков, описанными в разделе Основные сведения о проблемах потоков. |
| IUIAutomation::AddFocusChangedEventHandler Регистрирует метод, обрабатывающий события изменения фокуса. Примечание. Перед реализацией обработчика событий необходимо ознакомиться с проблемами потоков, описанными в разделе Основные сведения о проблемах потоков. |
| IUIAutomation::AddPropertyChangedEventHandler Регистрирует метод, обрабатывающий и массив событий изменения свойства. |
| IUIAutomation::AddPropertyChangedEventHandlerNativeArray Регистрирует метод, обрабатывающий собственный массив событий изменения свойства. |
| IUIAutomation::AddStructureChangedEventHandler Регистрирует метод, обрабатывающий события изменения структуры. Примечание. Перед реализацией обработчика событий необходимо ознакомиться с проблемами потоков, описанными в разделе Основные сведения о проблемах потоков. |
| IUIAutomation::CheckNotSupported Проверяет предоставленный variant, чтобы узнать, содержит ли он идентификатор Not Supported. |
| IUIAutomation::CompareElements Сравнивает два элемента модель автоматизации пользовательского интерфейса, чтобы определить, представляют ли они один и тот же базовый элемент пользовательского интерфейса. |
| IUIAutomation::CompareRuntimeIds Сравнивает два целочисленных массива, содержащих идентификаторы времени выполнения, чтобы определить, является ли их содержимое одинаковым и принадлежат ли они одному и тому же элементу пользовательского интерфейса. |
| IUIAutomation::CreateAndCondition Создает условие, которое выбирает элементы, соответствующие обоим двум условиям. |
| IUIAutomation::CreateAndConditionFromArray Создает условие, которое выбирает элементы на основе нескольких условий, все из которых должны быть истинными. |
| IUIAutomation::CreateAndConditionFromNativeArray Создает условие, которое выбирает элементы из собственного массива на основе нескольких условий, которые должны выполняться. |
| IUIAutomation::CreateCacheRequest Создает запрос кэша. |
| IUIAutomation::CreateFalseCondition Создает условие, которое всегда имеет значение false. |
| IUIAutomation::CreateNotCondition Создает условие, которое является отрицательным для указанного условия. |
| IUIAutomation::CreateOrCondition Создает сочетание двух условий, в которых существует соответствие, если любое из условий имеет значение true. |
| IUIAutomation::CreateOrConditionFromArray Создает сочетание двух или более условий, в которых существует соответствие, если какое-либо из условий имеет значение true. |
| IUIAutomation::CreateOrConditionFromNativeArray Создает сочетание двух или более условий, в которых существует соответствие, если какое-либо из условий имеет значение true. |
| IUIAutomation::CreatePropertyCondition Создает условие, которое выбирает элементы со свойством с указанным значением. |
| IUIAutomation::CreatePropertyConditionEx Создает условие, которое выбирает элементы со свойством с указанным значением, используя необязательные флаги. |
| IUIAutomation::CreateProxyFactoryEntry Создает новый экземпляр объекта фабрики прокси-сервера. |
| IUIAutomation::CreateTreeWalker Извлекает объект walker дерева, который можно использовать для обхода дерева Microsoft модель автоматизации пользовательского интерфейса. |
| IUIAutomation::CreateTrueCondition Извлекает предопределенное условие, которое выбирает все элементы. |
| IUIAutomation::ElementFromHandle Извлекает элемент модель автоматизации пользовательского интерфейса для указанного окна. |
| IUIAutomation::ElementFromHandleBuildCache Извлекает элемент модель автоматизации пользовательского интерфейса для указанного окна, предварительно извлекает запрошенные свойства и шаблоны элементов управления и сохраняет предварительно полученные элементы в кэше. |
| IUIAutomation::ElementFromIAccessible Извлекает элемент модель автоматизации пользовательского интерфейса для указанного объекта со специальными возможностями с сервера Microsoft Active Accessibility. |
| IUIAutomation::ElementFromIAccessibleBuildCache Извлекает элемент модель автоматизации пользовательского интерфейса для указанного доступного объекта с сервера Microsoft Active Accessibility, предварительно получает запрошенные свойства и шаблоны элементов управления и сохраняет предварительно полученные элементы в кэше. |
| IUIAutomation::ElementFromPoint Извлекает элемент модель автоматизации пользовательского интерфейса в указанной точке рабочего стола. |
| IUIAutomation::ElementFromPointBuildCache Извлекает элемент модель автоматизации пользовательского интерфейса в указанной точке на рабочем столе, предварительно извлекает запрошенные свойства и шаблоны элементов управления и сохраняет предварительно полученные элементы в кэше. |
| IUIAutomation::get_ContentViewCondition Извлекает предопределенный интерфейс IUIAutomationCondition, который выбирает элементы содержимого. |
| IUIAutomation::get_ContentViewWalker Извлекает интерфейс IUIAutomationTreeWalker, используемый для обнаружения элементов содержимого. |
| IUIAutomation::get_ControlViewCondition Извлекает предопределенный интерфейс IUIAutomationCondition, который выбирает элементы управления. |
| IUIAutomation::get_ControlViewWalker Извлекает интерфейс IUIAutomationTreeWalker, используемый для обнаружения элементов управления. |
| IUIAutomation::get_ProxyFactoryMapping Извлекает объект , представляющий сопоставление имен классов Window и связанных данных с отдельными прокси-фабриками. |
| IUIAutomation::get_RawViewCondition Извлекает предопределенный интерфейс IUIAutomationCondition, который выбирает все элементы пользовательского интерфейса в нефильтрованном представлении. |
| IUIAutomation::get_RawViewWalker Извлекает объект обхода дерева, используемый для обхода нефильтрованного представления дерева Microsoft модель автоматизации пользовательского интерфейса. |
| IUIAutomation::get_ReservedMixedAttributeValue Извлекает статический объект токена, представляющий текстовый атрибут, который является смешанным атрибутом. |
| IUIAutomation::get_ReservedNotSupportedValue Извлекает объект статического маркера, представляющий свойство или текстовый атрибут, который не поддерживается. |
| IUIAutomation::GetFocusedElement Извлекает элемент модель автоматизации пользовательского интерфейса с фокусом ввода. |
| IUIAutomation::GetFocusedElementBuildCache Извлекает элемент модель автоматизации пользовательского интерфейса с фокусом ввода, предварительно извлекает запрошенные свойства и шаблоны элементов управления и сохраняет предварительно полученные элементы в кэше. |
| IUIAutomation::GetPatternProgrammaticName Извлекает зарегистрированное программное имя шаблона элемента управления. |
| IUIAutomation::GetPropertyProgrammaticName Извлекает зарегистрированное программное имя свойства. |
| IUIAutomation::GetRootElement Извлекает элемент модель автоматизации пользовательского интерфейса, представляющий рабочий стол. |
| IUIAutomation::GetRootElementBuildCache Извлекает элемент модель автоматизации пользовательского интерфейса, представляющий рабочий стол, предварительно извлекает запрошенные свойства и шаблоны элементов управления и сохраняет предварительно полученные элементы в кэше. |
| IUIAutomation::IntNativeArrayToSafeArray Преобразует массив целых чисел в SAFEARRAY. |
| IUIAutomation::IntSafeArrayToNativeArray Преобразует SAFEARRAY целых чисел в массив. |
| IUIAutomation::P ollForPotentialSupportedPatterns Извлекает шаблоны элементов управления, которые могут поддерживаться в элементе модель автоматизации пользовательского интерфейса. |
| IUIAutomation::P ollForPotentialSupportedProperties Извлекает свойства, которые могут поддерживаться в элементе модель автоматизации пользовательского интерфейса. |
| IUIAutomation::RectToVariant Создает variant, содержащий координаты прямоугольника. |
| IUIAutomation::RemoveAllEventHandlers Удаляет все зарегистрированные обработчики событий Microsoft модель автоматизации пользовательского интерфейса. |
| IUIAutomation::RemoveAutomationEventHandler Удаляет указанный обработчик событий модель автоматизации пользовательского интерфейса. |
| IUIAutomation::RemoveFocusChangedEventHandler Удаляет обработчик событий, измененных фокусом. |
| IUIAutomation::RemovePropertyChangedEventHandler Удаляет обработчик событий изменения свойства. |
| IUIAutomation::RemoveStructureChangedEventHandler Удаляет обработчик событий, измененных в структуре. |
| IUIAutomation::SafeArrayToRectNativeArray Преобразует объект SAFEARRAY, содержащий координаты прямоугольника, в массив типа RECT. |
| IUIAutomation::VariantToRect Преобразует объект VARIANT, содержащий координаты прямоугольника, в rect. |
Комментарии
Каждое клиентское приложение модель автоматизации пользовательского интерфейса должно получить этот интерфейс для объекта CUIAutomation, чтобы получить доступ к функциям модель автоматизации пользовательского интерфейса.
В следующем примере функция создает объект CUIAutomation и получает интерфейс IUIAutomation .
IUIAutomation *g_pAutomation;
BOOL InitializeUIAutomation()
{
CoInitialize(NULL);
HRESULT hr = CoCreateInstance(__uuidof(CUIAutomation), NULL, CLSCTX_INPROC_SERVER,
__uuidof(IUIAutomation), (void**)&g_pAutomation);
return (SUCCEEDED(hr));
}
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista, Windows XP с пакетом обновления 3 (SP3) и Обновление платформы для Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008, Windows Server 2003 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | uiautomationclient.h (включая UIAutomation.h) |
См. также раздел
Интерфейсы элементов модель автоматизации пользовательского интерфейса для клиентов