Partager via


Prise en charge d'UI Automation pour le type de contrôle Window

RemarqueRemarque

Cette documentation s'adresse aux développeurs .NET Framework qui veulent utiliser les classes UI Automation managées définies dans l'espace de noms System.Windows.Automation.Pour obtenir les informations les plus récentes sur UI Automation, consultez API Windows Automation : UI Automation (page éventuellement en anglais).

Cette rubrique fournit des informations sur la prise en charge UI Automation pour type de contrôle Window. Dans UI Automation, un type de contrôle est un ensemble de conditions qu'un contrôle doit respecter afin d'utiliser la propriété ControlTypeProperty. Les conditions incluent des instructions spécifiques pour l'arborescence UI Automation, les valeurs de propriété UI Automation et les modèles de contrôle.

Le contrôle de fenêtre se compose d'un frame de fenêtre, qui contient des objets enfants tels que la barre de titre, le client et d'autres objets.

Les conditions requises UI Automation dans les sections suivantes s'appliquent à tous les contrôles qui implémentent le type de contrôle Window, qu'il s'agisse de Windows Presentation Foundation (WPF), Win32 ou Windows Forms.

Cette rubrique comprend les sections suivantes.

  • Arborescence UI Automation requise
  • Propriétés UI Automation requises
  • Modèles de contrôle UI Automation requis
  • Événements UI Automation requis
  • Rubriques connexes

Arborescence UI Automation requise

Le tableau suivant représente l'affichage de contrôle et l'affichage du contenu de l'arborescence UI Automation concernant les contrôles de fenêtre et décrit ce qui peut être inclus dans chaque affichage. Pour plus d'informations sur l'arborescence UI Automation, consultez Vue d'ensemble de l'arborescence UI Automation.

Affichage de contrôle

Affichage du contenu

Window

Window

Propriétés UI Automation requises

Le tableau suivant répertorie les propriétés UI Automation dont la valeur ou la définition est particulièrement pertinente pour les contrôles de fenêtre. Pour plus d'informations sur les propriétés UI Automation, consultez Propriétés UI Automation pour les clients.

Propriété UI Automation

Valeur

Remarques

AutomationIdProperty

Consulter les remarques.

La valeur de cette propriété doit être unique dans tous les contrôles d'une application.

BoundingRectangleProperty

Consulter les remarques.

Le rectangle le plus éloigné qui contient l'ensemble du contrôle.

ClickablePointProperty

Consulter les remarques.

Le contrôle de fenêtre doit avoir un point interactif qui provoquera l'activation ou la désactivation de la fenêtre.

ControlTypeProperty

Window

Cette valeur est la même pour toutes les infrastructures d'interface utilisateur.

IsContentElementProperty

True

Le contrôle Window doit toujours être du contenu.

IsControlElementProperty

True

Le contrôle Window doit toujours être un contrôle.

IsKeyboardFocusableProperty

Consulter les remarques.

Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.

LabeledByProperty

null

Les contrôles Window n'ont pas d'étiquette de fenêtre statiques.

LocalizedControlTypeProperty

"window"

Chaîne localisée correspondant au type de contrôle Window.

NameProperty

Consulter les remarques.

Le contrôle Window contient toujours un élément Window principal qui se rapporte à ce que l'utilisateur associerait comme identificateur le plus sémantique pour l'élément.

Modèles de contrôle UI Automation requis

Le tableau suivant répertorie les modèles de contrôle UI Automation qui doivent être pris en charge par les contrôles Window. Pour plus d'informations sur les modèles de contrôle, consultez Vue d'ensemble des modèles de contrôle UI Automation.

Modèle de contrôle

Prise en charge

Remarques

IDockProvider

Conditionnel

Doit être pris en charge si la fenêtre a la capacité d'être ancrée.

ITransformProvider

Obligatoire

Permet à la fenêtre d'être déplacée, redimensionnée ou pivotée sur l'écran.

IWindowProvider

Obligatoire

Active des opérations spécifiques pour la fenêtre.

Événements UI Automation requis

Le tableau suivant répertorie les événements UI Automation requis afin d'être pris en charge par tous les contrôles Window. Pour plus d'informations sur les événements, consultez Vue d'ensemble des événements UI Automation.

Événement UI Automation

Prise en charge

Remarques

AsyncContentLoadedEvent

Obligatoire

Aucun

AutomationFocusChangedEvent

Obligatoire

Aucun

Événement de modification de propriété BoundingRectangleProperty.

Obligatoire

Aucun

Événement de modification de propriété IsEnabledProperty.

Obligatoire

Aucun

Événement de modification de propriété IsOffscreenProperty.

Obligatoire

Aucun

LayoutInvalidatedEvent

Obligatoire

Aucun

Événement de modification de propriété NameProperty.

Obligatoire

Aucun

StructureChangedEvent

Obligatoire

Aucun

Événement de modification de propriété HorizontallyScrollableProperty.

Selon le cas

Aucun

Événement de modification de propriété HorizontalScrollPercentProperty.

Selon le cas

Aucun

Événement de modification de propriété HorizontalViewSizeProperty.

Selon le cas

Aucun

Événement de modification de propriété VerticalScrollPercentProperty .

Selon le cas

Aucun

Événement de modification de propriété VerticallyScrollableProperty.

Selon le cas

Aucun

Événement de modification de propriété VerticalViewSizeProperty.

Selon le cas

Aucun

WindowClosedEvent

Obligatoire

Aucun

WindowOpenedEvent

Obligatoire

Aucun

Événement de modification de propriété WindowVisualStateProperty.

Selon le cas

Aucun

Voir aussi

Référence

Window

Concepts

Vue d'ensemble des types de contrôle UI Automation

Vue d'ensemble d'UI Automation