Método IUIAutomationElement3::get_CurrentIsPeripheral (uiautomationclient.h)

Artículo
03/08/2023

Recupera el indicador de interfaz de usuario periférico actual para el elemento .

Esta propiedad es de solo lectura.

Sintaxis

HRESULT get_CurrentIsPeripheral(
  BOOL *retVal
);

Parámetros

retVal

Valor devuelto

None

Observaciones

Cuando la propiedad IsPeripheral es TRUE, una aplicación cliente no puede suponer que el elemento ha tomado el foco incluso si actualmente es interactivo con el teclado.

Esta propiedad es relevante para estos tipos de control:

UIA_GroupControlTypeId
UIA_MenuControlTypeId
UIA_PaneControlTypeId
UIA_ToolBarControlTypeId
UIA_ToolTipControlTypeId
UIA_WindowControlTypeId
UIA_CustomControlTypeId

La apariencia de la interfaz de usuario de periféricos suele desencadenar uno de estos eventos, si la interfaz de usuario periférica admite uno de los patrones pertinentes:

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

Cuando las aplicaciones cliente que son tecnologías de asistencia controlan uno de estos eventos, el cliente debe comprobar el valor de CurrentIsPeripheral. Si el valor es TRUE, es posible que el cliente tenga que proporcionar una representación alternativa de la interfaz de usuario periférica a la que el usuario puede llegar con una sola acción, ya que el cliente no puede usar el foco cambiado como un indicador de la nueva interfaz de usuario o una interfaz de usuario de interés. De lo contrario, la interfaz de usuario de periféricos no existirá en la vista de control, la secuencia de tabulaciones, etc. Se garantiza que un cliente solo existe un elemento de interfaz de usuario periférico en el árbol general en cualquier momento, al abrir otro se cerraría automáticamente el primero.

Requisitos


Cliente mínimo compatible	Windows 8.1 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	uiautomationclient.h (include UIAutomation.h)

Consulte también

IUIAutomationElement3

Referencia

Share via