Partager via

Prise en charge d’UI Automation pour le type de contrôle de document

Remarque

Cette documentation est destinée aux développeurs .NET Framework qui souhaitent 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.

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

Les contrôles de document permettent à un utilisateur d’afficher et de manipuler plusieurs pages de texte. Contrairement aux contrôles de modification qui prennent uniquement en charge une ligne simple de texte non mis en forme, les contrôles de document peuvent héberger du texte richement style et mis en forme.

Les sections suivantes définissent la structure d’arborescence, les propriétés, les modèles de contrôle et les événements UI Automation requis pour le type de contrôle Document. Les exigences UI Automation s’appliquent à tous les contrôles de document, que Windows Presentation Foundation (WPF), Win32 ou Windows Forms.

Arborescence UI Automation obligatoire

Le tableau suivant illustre l’affichage de contrôle et l’affichage de contenu de l’arborescence UI Automation qui se rapporte aux contrôles de document et décrit ce qui peut être contenu dans chaque vue. Pour plus d’informations sur l’arborescence UI Automation, consultez vue d’ensemble de l’arborescence UI Automation.

Affichage de contrôle Affichage de contenu
Document

-Varie		 Document

-Varie

Propriétés UI Automation obligatoires

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 document. 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 Consultez les remarques. La valeur de cette propriété doit être unique sur tous les contrôles d’une application.
BoundingRectangleProperty Consultez les remarques. Rectangle externe qui contient l’ensemble du contrôle.
ClickablePointProperty Consultez les remarques. Le document a un point cliquable qui entraîne le focus sur le document d’un de ses éléments dans le conteneur de documents.
ControlTypeProperty Document Cette valeur est la même pour toutes les infrastructures d’interface utilisateur.
IsContentElementProperty Vrai Le contrôle de document est toujours inclus dans la vue de contenu de l’arborescence UI Automation.
IsControlElementProperty Vrai Le contrôle de document est toujours inclus dans l’affichage de contrôle de l’arborescence UI Automation.
IsKeyboardFocusableProperty Consultez les remarques. Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
LabeledByProperty Consultez les remarques. La valeur de cette propriété doit être l’étiquette du contrôle de document. En règle générale, le titre du document est utilisé.
LocalizedControlTypeProperty « document » Chaîne localisée correspondant au type de contrôle Document.
NameProperty Consultez les remarques. Le contrôle de document obtient généralement ses noms à partir du nom de fichier à partir duquel il est chargé. Il s’agit souvent d’une fenêtre contenante ou d’un titre de cadre.

Modèles de contrôle UI Automation obligatoires

Le tableau suivant répertorie les modèles de contrôle UI Automation requis pour être pris en charge par les contrôles de document. 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 Soutien Remarques
IScrollProvider Dépend Le contrôle de document peut s’étendre sur une étendue supérieure à celle de la fenêtre d’affichage. Le contrôle doit prendre en charge le modèle de contrôle Scroll si le contenu est défilant.
ITextProvider Obligatoire Le contrôle de document peut s’étendre sur une étendue supérieure à celle de la fenêtre d’affichage. Le contrôle doit prendre en charge le modèle de contrôle Scroll si le contenu est défilant.
IValueProvider Jamais Le contrôle de document ne prend pas en charge ce modèle de contrôle, car le contenu du contrôle s’étend souvent sur plusieurs pages. Les clients UI Automation doivent utiliser TextPattern pour obtenir des informations textuelles sur un document.

Événements UI Automation obligatoires

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

Événement UI Automation Soutien Remarques
AutomationFocusChangedEvent Obligatoire Aucun
Événement de modification de la propriété BoundingRectangleProperty. Obligatoire Aucun
Événement de modification de la propriété IsEnabledProperty. Obligatoire Aucun
Événement de modification de la propriété IsOffscreenProperty. Obligatoire Aucun
StructureChangedEvent Obligatoire Aucun
Événement de modification de la propriété HorizontallyScrollableProperty. Obligatoire Aucun
Événement de modification de la propriété HorizontalScrollPercentProperty. Obligatoire Aucun
Événement de modification de la propriété HorizontalViewSizeProperty. Obligatoire Aucun
Événement de modification de la propriété VerticalScrollPercentProperty. Obligatoire Aucun
Événement de modification de la propriété VerticallyScrollableProperty. Obligatoire Aucun
Événement de modification de la propriété VerticalViewSizeProperty. Obligatoire Aucun
InvalidatedEvent Dépend Si le contrôle prend en charge le modèle de contrôle Sélection, il doit prendre en charge cet événement.
TextSelectionChangedEvent Obligatoire Aucun
TextChangedEvent Obligatoire Aucun
Événement de modification de la propriété ValueProperty. Jamais Aucun

Voir aussi