Compartilhar via


Método IUIAutomationCacheRequest::get_AutomationElementMode (uiautomationclient.h)

Indica se os elementos retornados contêm referências completas à interface do usuário subjacente ou apenas informações armazenadas em cache.

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT get_AutomationElementMode(
  AutomationElementMode *mode
);

Parâmetros

mode

Valor retornado

Nenhum

Comentários

AutomationElementMode_Full é o valor padrão e especifica que os elementos retornados contêm uma referência completa à interface do usuário subjacente. AutomationElementMode_None especifica que os elementos retornados não têm referência à interface do usuário subjacente e contêm apenas informações armazenadas em cache.

Determinadas operações em elementos, incluindo GetCurrentPropertyValue e SetFocus, exigem uma referência completa; tentar executá-los em um elemento que não tem nenhum resulta em um erro.

Usar AutomationElementMode_None pode ser mais eficiente quando apenas as propriedades são necessárias, pois evita a sobrecarga envolvida na configuração de referências completas.

Requisitos

   
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista, Windows XP com SP3 e Atualização de Plataforma para Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008, Windows Server 2003 com SP2 e Atualização de Plataforma para Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho uiautomationclient.h (inclua UIAutomation.h)