AutomationElement.AutomationElementInformation.IsOffscreen Propriedade

Definição

Namespace:

System.Windows.Automation

Assembly:

UIAutomationClient.dll

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

Boolean

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.