Share via


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

Recupera o indicador de interface do usuário periférico armazenado em cache para o elemento . A interface do usuário periférica é exibida e dá suporte à interação do usuário, mas não assume o foco do teclado quando ela aparece. Exemplos de interface do usuário periférica incluem pop-ups, submenus, menus de contexto ou notificações flutuantes.

Esta propriedade é somente para leitura.

Sintaxe

HRESULT get_CachedIsPeripheral(
  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 obtido pelo elemento, mesmo que ele seja interativo no momento por teclado.

Essa propriedade é relevante para esses 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 dá suporte a um dos padrões relevantes:
  • WindowOpened (UIA_Window_WindowOpenedEventId)
  • MenuAbrir (UIA_MenuOpenedEventId)
  • ToolTipOpened (UIA_ToolTipOpenedEventId)

Requisitos

Requisito Valor
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 (inclua UIAutomation.h)

Confira também

IUIAutomationElement3

Referência