Интерфейс 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)

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

Интерфейсы элементов модель автоматизации пользовательского интерфейса для клиентов