Compartir a través de


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

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