Partager via


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

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 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 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.

Les contrôles Document permettent à un utilisateur de voir et de manipuler plusieurs pages de texte. Contrairement aux contrôles d'édition qui prennent uniquement en charge une simple ligne de texte non mise en forme, les contrôles de document peuvent héberger du texte utilisant une mise en forme et un style enrichis.

Les sections suivantes définissent l'arborescence UI Automation, les propriétés, les modèles de contrôle et les événements requis pour le type de contrôle Document. Les spécifications UI Automation s'appliquent à tous les contrôles de document, 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 document 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

Document

  • Selon le cas

Document

  • Selon le cas

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 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

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 document dispose d'un point interactif qui permettra au document de l'un de ses éléments du conteneur de documents d'avoir le focus.

ControlTypeProperty

Document

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

IsContentElementProperty

True

Le contrôle de document est toujours inclus dans l'affichage du contenu de l'arborescence UI Automation.

IsControlElementProperty

True

Le contrôle de document est toujours inclus dans l'affichage de contrôle de l'arborescence UI Automation.

IsKeyboardFocusableProperty

Consulter les remarques.

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

LabeledByProperty

Consulter les remarques.

La valeur de cette propriété doit être l'étiquette du contrôle de document. En général, on utilise le titre du document.

LocalizedControlTypeProperty

"document"

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

NameProperty

Consulter les remarques.

Le nom du contrôle de document correspond en général au nom de fichier à partir duquel il est chargé. La plupart du temps il est affiché dans un titre de fenêtre ou de frame.

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 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

Prise en charge

Remarques

IScrollProvider

Selon le cas

Le contrôle de document peut couvrir 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 couvrir 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 couvre souvent plusieurs pages. Les clients UI Automation doivent utiliser TextPattern pour obtenir des informations textuelles sur un document.

Événements UI Automation requis

Le tableau suivant répertorie les événements UI Automation qui doivent ê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

Prise en charge

Remarques

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

StructureChangedEvent

Obligatoire

Aucun

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

Obligatoire

Aucun

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

Obligatoire

Aucun

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

Obligatoire

Aucun

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

Obligatoire

Aucun

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

Obligatoire

Aucun

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

Obligatoire

Aucun

InvalidatedEvent

Selon le cas

Si le contrôle prend en charge le modèle de contrôle Selection, il doit prendre en charge cet événement.

TextSelectionChangedEvent

Obligatoire

Aucun

TextChangedEvent

Obligatoire

Aucun

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

Jamais

Aucun

Voir aussi

Référence

Document

Concepts

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

Vue d'ensemble d'UI Automation