AutomationElement.AutomationElementInformation.IsOffscreen Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém um valor que indica se o elemento de Automação da Interface do Usuário está visível na tela.
public:
property bool IsOffscreen { bool get(); };
public bool IsOffscreen { get; }
member this.IsOffscreen : bool
Public ReadOnly Property IsOffscreen As Boolean
Valor da propriedade
true
se o controle não estiver visível; caso contrário, false
.
Comentários
Um valor booliano que indica se um elemento é completamente rolado (por exemplo, um item em uma caixa de listagem está fora do visor do objeto contêiner) ou recolhido (por exemplo, um item em um modo de exibição de árvore, menu ou uma janela minimizada) fora da exibição.
Se o elemento tiver um ponto clicável que possa fazer com que ele se concentre, ele será considerado na tela mesmo quando uma parte do elemento estiver fora da tela.
O valor da propriedade não é afetado pela oclusão por outras janelas ou se o elemento está visível em um monitor específico.
Quando IsOffscreen é true,
um elemento que é rolado ou recolhido para fora da exibição, mas ainda faz parte da percepção dos usuários finais da interface do usuário, pode ser colocado de volta à exibição por manipulação simples, como rolar ou clicar em um controle suspenso.
Se o elemento for algo que o usuário final não percebe ou é chamado de "ocultado programaticamente" (por exemplo, uma caixa de diálogo que foi ignorada, mas onde o objeto de sublinhado é armazenado em cache pelo aplicativo), ele deve ser removido da árvore de elementos em vez de definir o valor de IsOffscreen como true
.
Quando o valor é true
para um contêiner, ele também true
é para descendentes do elemento de contêiner.
Para obter mais informações, consulte IsOffscreenProperty.