Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 Volet. 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 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 de cadre ou de document. Les utilisateurs peuvent naviguer entre les contrôles de volet et dans le contenu du volet actif, mais ne peuvent pas naviguer entre les éléments dans différents volets. Par conséquent, les contrôles de volet représentent un niveau de regroupement inférieur aux fenêtres ou documents, mais au-dessus des contrôles individuels. L’utilisateur navigue entre les volets en appuyant sur Tab, F6 ou Ctrl+Tab, en fonction du contexte. Aucune navigation au clavier spécifique n’est requise par le type de contrôle Volet.
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 Pane. Les exigences UI Automation s’appliquent à tous les contrôles de liste, que Windows Presentation Foundation (WPF), Win32 ou Windows Forms.
Arborescence UI Automation obligatoire
Le tableau suivant illustre la vue de contrôle et la vue de contenu de l’arborescence UI Automation qui se rapporte aux contrôles de volet 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 |
|---|---|
| Panneau | Panneau |
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 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 | 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. |
| IsKeyboardFocusableProperty | Consultez les remarques. | Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété. |
| NameProperty | Consultez les remarques. | La valeur de cette propriété doit toujours être un titre clair, concis et explicite. |
| ClickablePointProperty | Consultez les remarques. | Cette propriété expose un point cliquable du contrôle de volet qui entraîne le focus du volet lorsqu’il est cliqué. |
| LabeledByProperty | Consultez les remarques. | Les contrôles de volet n’ont généralement pas d’étiquette statique. S’il existe une étiquette de texte statique, elle doit être exposée via cette propriété. |
| ControlTypeProperty | Panneau | Cette valeur est identique pour toutes les infrastructures d’interface utilisateur. |
| LocalizedControlTypeProperty | « volet » | Chaîne localisée correspondant au type de contrôle Pane. |
| IsContentElementProperty | Vrai | Les contrôles de volet sont toujours inclus dans la vue de contenu de l’arborescence UI Automation. |
| IsControlElementProperty | Vrai | Les contrôles de volet sont toujours inclus dans la vue de contrôle de l’arborescence UI Automation. |
| HelpTextProperty | "" | Le texte d’aide pour les contrôles de volet doit expliquer pourquoi l’objectif du cadre et la façon dont il se rapporte à d’autres cadres. Une description est nécessaire si l’objectif et la relation des images ne sont pas claires de la valeur du NameProperty. "" |
| AccessKeyProperty | Consultez les remarques. | Si une combinaison de touches spécifique donne le focus au volet, ces informations doivent être exposées via cette propriété. |
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 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 | Soutien | Remarques |
|---|---|---|
| ITransformProvider | Dépend | 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 Window contrôle. |
| IDockProvider | Dépend | Implémentez ce modèle de contrôle si le contrôle de volet peut être ancré. |
| IScrollProvider | Dépend | Implémentez ce modèle de contrôle si le contrôle de volet peut être défilement. |
É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 volet. Pour plus d’informations sur les événements, consultez UI Automation Events Overview.
| Événement UI Automation | Prise en charge/valeur | Remarques |
|---|---|---|
| WindowClosedEvent | Jamais | Aucun |
| WindowOpenedEvent | Jamais | Aucun |
| AsyncContentLoadedEvent | Obligatoire | Aucun |
| Événement de modification de la propriété BoundingRectangleProperty. | Obligatoire | Aucun |
| Événement de modification de la propriété IsOffscreenProperty. | Obligatoire | Aucun |
| Événement de modification de la propriété IsEnabledProperty. | Obligatoire | Aucun |
| Événement de modification de la propriété HorizontallyScrollableProperty. | Dépend | Aucun |
| Événement de modification de la propriété HorizontalScrollPercentProperty. | Dépend | Aucun |
| Événement de modification de la propriété HorizontalViewSizeProperty. | Dépend | Aucun |
| Événement de modification de la propriété VerticalScrollPercentProperty. | Dépend | Aucun |
| Événement de modification de la propriété VerticallyScrollableProperty. | Dépend | Aucun |
| Événement de modification de la propriété VerticalViewSizeProperty. | Dépend | Aucun |
| Événement de modification de la propriété WindowVisualStateProperty. | Jamais | Aucun |
| AutomationFocusChangedEvent | Obligatoire | Aucun |
| StructureChangedEvent | Obligatoire | Aucun |
Exemple de type de contrôle de volet
L’image suivante illustre un contrôle qui implémente le type de contrôle Pane.
| Arborescence UI Automation - Vue contrôle | Arborescence UI Automation - Affichage contenu |
|---|---|
|
-Vitre - Arborescence (modèle de défilement) - TreeItem - … Vitre -Éditer - (Modèle de défilement) |