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

Article
08/10/2011

Remarque
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 Pane. 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 type de contrôle Pane est utilisé pour représenter un objet dans une fenêtre frame ou une fenêtre de document. Les utilisateurs peuvent naviguer entre les contrôles de volet et dans le contenu du volet actif, mais ils ne peuvent pas naviguer entre les éléments de différents volets. Par conséquent, les contrôles de volet représentent un niveau de regroupement inférieur à celui des fenêtres et des documents, mais supérieur à celui des contrôles individuels. L'utilisateur navigue entre les volets en appuyant sur TAB, F6 ou CTRL+TAB, selon le contexte. Aucune navigation au clavier spécifique n'est requise par le type de contrôle Pane.

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 Pane. Les spécifications UI Automation s'appliquent à tous les contrôles de liste, 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
Type de contrôle Pane, exemple
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 volet 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
Pane	Pane

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 volet. 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é contient l'ensemble du contrôle.
IsKeyboardFocusableProperty	Consulter les remarques.	Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.
NameProperty	Consulter les remarques.	La valeur de cette propriété doit toujours être un titre clair, concis et explicite.
ClickablePointProperty	Consulter les remarques.	Cette propriété expose un point interactif du contrôle de volet qui donne le focus au volet lorsque vous cliquez dessus.
LabeledByProperty	Consulter les remarques.	Généralement, les contrôles de volet n'ont pas d'étiquette statique. S'ils en ont une, elle doit être exposée via cette propriété.
ControlTypeProperty	Pane	Cette valeur est la même pour toutes les infrastructures d'UI.
LocalizedControlTypeProperty	"volet"	Chaîne localisée correspondant au type de contrôle Pane.
IsContentElementProperty	True	Les contrôles de volet sont toujours inclus dans l'affichage du contenu de l'arborescence UI Automation.
IsControlElementProperty	True	Les contrôles de volet sont toujours inclus dans l'affichage de contrôle de l'arborescence UI Automation.
HelpTextProperty	""	Le texte d'aide pour les contrôles de volet doit expliquer le but de la frame et sa relation avec les autres frames. Si le but et la relation des frames ne sont pas clairs depuis la valeur du NameProperty, une description est nécessaire. "
AccessKeyProperty	Consulter les remarques.	Si une combinaison de touches spécifique donne le focus au volet, alors ces informations doivent être exposées via cette propriété.

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 tous les contrôles de volet. 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
ITransformProvider	Selon le cas	Implémentez ce modèle de contrôle si le contrôle de volet peut être déplacé, redimensionné ou pivoté sur l'écran.
IWindowProvider	Jamais	Si vous devez implémenter ce modèle de contrôle, votre contrôle doit être basé sur le type de contrôle Window.
IDockProvider	Selon le cas	Implémentez ce modèle de contrôle si le contrôle de volet peut être ancré.
IScrollProvider	Selon le cas	Implémentez ce modèle de contrôle si le contrôle de volet peut défiler.

É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 volet. Pour plus d'informations sur les événements, consultez Vue d'ensemble des événements UI Automation.

Événement UI Automation	Prise en charge/Valeur	Remarques
WindowClosedEvent	Jamais	Aucun
WindowOpenedEvent	Jamais	Aucun
AsyncContentLoadedEvent	Obligatoire	Aucun
Événement de modification de propriété BoundingRectangleProperty.	Obligatoire	Aucun
Événement de modification de propriété IsOffscreenProperty.	Obligatoire	Aucun
Événement de modification de propriété IsEnabledProperty.	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
Événement de modification de propriété WindowVisualStateProperty.	Jamais	Aucun
AutomationFocusChangedEvent	Obligatoire	Aucun
StructureChangedEvent	Obligatoire	Aucun