Метод IUIAutomationElement3::get_CurrentIsPeripheral (uiautomationclient.h)

Статья
08/26/2023

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

Это свойство доступно только для чтения.

Синтаксис

HRESULT get_CurrentIsPeripheral(
  BOOL *retVal
);

Параметры

retVal

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

None

Remarks

Если свойство IsPeripheral имеет значение TRUE, клиентское приложение не может предположить, что фокус был занят элементом, даже если он в настоящее время является интерактивным с помощью клавиатуры.

Это свойство относится к следующим типам элементов управления:

UIA_GroupControlTypeId
UIA_MenuControlTypeId
UIA_PaneControlTypeId
UIA_ToolBarControlTypeId
UIA_ToolTipControlTypeId
UIA_WindowControlTypeId
UIA_CustomControlTypeId

Внешний вид периферийного пользовательского интерфейса часто вызывает одно из следующих событий, если периферийный пользовательский интерфейс поддерживает один из соответствующих шаблонов:

WindowOpened (UIA_Window_WindowOpenedEventId)
MenuOpened (UIA_MenuOpenedEventId)
ToolTipOpened (UIA_ToolTipOpenedEventId)

Когда клиентские приложения, которые являются вспомогательными технологиями, обрабатывают одно из этих событий, клиент должен проверка значение CurrentIsPeripheral. Если значение равно TRUE, клиенту может потребоваться предоставить альтернативное представление периферийного пользовательского интерфейса, к которому пользователь может обращаться с помощью одного действия, так как клиент не может использовать измененный фокус в качестве индикатора нового пользовательского интерфейса или интересующего пользователя пользовательского интерфейса. В противном случае периферийный пользовательский интерфейс не будет существовать в представлении элемента управления, последовательности вкладок и т. д. Клиент гарантирует, что только один периферийный элемент пользовательского интерфейса существует в общем дереве в любой момент времени. Открытие другого приведет к автоматическому закрытию первого элемента.

Требования


Минимальная версия клиента	Windows 8.1 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 R2 [только классические приложения]
Целевая платформа	Windows
Header	uiautomationclient.h (включая UIAutomation.h)

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

IUIAutomationElement3

Справочные материалы

Поделиться через