Share via

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

  • Artigo

Recupera o indicador de interface do usuário periférico atual para o elemento .

Esta propriedade é somente para leitura.

Sintaxe

HRESULT get_CurrentIsPeripheral(
  BOOL *retVal
);

Parâmetros

retVal

Valor retornado

Nenhum

Comentários

Quando a propriedade IsPeripheral é TRUE, um aplicativo cliente não pode assumir que o foco foi tirado pelo elemento, mesmo que ele esteja atualmente interativo por teclado.

Essa propriedade é relevante para estes tipos de controle:

  • UIA_GroupControlTypeId
  • UIA_MenuControlTypeId
  • UIA_PaneControlTypeId
  • UIA_ToolBarControlTypeId
  • UIA_ToolTipControlTypeId
  • UIA_WindowControlTypeId
  • UIA_CustomControlTypeId
A aparência da interface do usuário periférica geralmente dispara um desses eventos, se a interface do usuário periférica der suporte a um dos padrões relevantes:
  • WindowOpened (UIA_Window_WindowOpenedEventId)
  • MenuAbrido (UIA_MenuOpenedEventId)
  • ToolTipOpened (UIA_ToolTipOpenedEventId)
Quando aplicativos cliente que são tecnologias adaptativas lidam com um desses eventos, o cliente deve marcar o valor de CurrentIsPeripheral. Se o valor for TRUE, talvez o cliente precise fornecer uma representação alternativa da interface do usuário periférica que o usuário pode alcançar com uma única ação, pois o cliente não pode usar o foco alterado como um indicador de nova interface do usuário ou uma interface do usuário de interesse. De outra forma, a interface do usuário periférica não existirá na exibição de controle, na sequência de tabulações e assim por diante. Um cliente tem a garantia de que existe apenas um item de interface do usuário periférico na árvore geral a qualquer momento, abrindo outro fecharia o primeiro automaticamente.

Requisitos

   
Cliente mínimo com suporte Windows 8.1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho uiautomationclient.h (include UIAutomation.h)

Confira também

IUIAutomationElement3

Referência