AutomationElement.AutomationElementInformation.IsOffscreen Propriété

Définition

Espace de noms:

System.Windows.Automation

Assembly:

UIAutomationClient.dll

Obtient une valeur qui indique si l’élément UI Automation est visible à l’écran.

public:
 property bool IsOffscreen { bool get(); };

public bool IsOffscreen { get; }

member this.IsOffscreen : bool

Public ReadOnly Property IsOffscreen As Boolean

Valeur de propriété

Boolean

true si le contrôle n'est pas visible ; sinon, false.

Remarques

Valeur booléenne qui indique si un élément fait l’objet d’un défilement complet (par exemple, un élément d’une zone de liste se trouve en dehors de la fenêtre d’affichage de l’objet conteneur) ou réduit (par exemple, un élément dans une arborescence, un menu ou une fenêtre réduite) hors de vue.

Si l’élément a un point cliquable qui peut le concentrer, il est considéré comme étant à l’écran même lorsqu’une partie de l’élément est hors écran.

La valeur de la propriété n’est pas affectée par l’occlusion par d’autres fenêtres, ni par le fait que l’élément soit visible sur un moniteur spécifique.

Lorsque IsOffscreen est true, un élément qui fait défiler ou réduit hors de l’affichage, mais qui fait toujours partie de la perception des utilisateurs finaux de l’interface utilisateur, peut être remis en vue par une manipulation simple, telle que le défilement ou le clic sur un contrôle de liste déroulante.

Si l’élément est quelque chose que l’utilisateur final ne perçoit pas du tout ou qu’il est appelé « masqué par programmation » (par exemple, une boîte de dialogue qui a été ignorée mais où l’objet de mise en avant est mis en cache par l’application), il doit être supprimé de l’arborescence des éléments au lieu de définir la valeur isOffscreen sur true.

Lorsque la valeur est true pour un conteneur, elle l’est également true pour les descendants de l’élément conteneur.

Pour plus d'informations, consultez IsOffscreenProperty.