Partager via

Modèles de contrôle et interfaces

  • Article

Liste les modèles de contrôle Microsoft UI Automation, les classes que les clients utilisent pour y accéder et les interfaces utilisées par les fournisseurs pour les implémenter.

Le tableau de cette rubrique décrit les modèles de contrôle Microsoft UI Automation. Le tableau répertorie également les classes utilisées par les clients UI Automation pour accéder aux modèles de contrôle et aux interfaces utilisées par les fournisseurs UI Automation pour les implémenter. La colonne Modèle de contrôle affiche le nom du modèle du point de vue du client UI Automation, sous la forme d’une valeur constante répertoriée dans les identificateurs de propriété de disponibilité du modèle de contrôle. Du point de vue du fournisseur UI Automation, chacun de ces modèles est un nom de constante PatternInterface. La colonne d’interface du fournisseur de classes affiche le nom de l’interface que les fournisseurs implémentent pour fournir ce modèle pour un contrôle XAML personnalisé.

Pour plus d’informations sur la façon d’implémenter des homologues d’automatisation personnalisés qui exposent des modèles de contrôle et implémentent les interfaces, consultez Homologues Automation personnalisés.

Lorsque vous implémentez un modèle de contrôle, vous devez également consulter la documentation du fournisseur UI Automation qui explique certaines des attentes que les clients auront d’un modèle de contrôle, quel que soit l’infrastructure d’interface utilisateur utilisée pour l’implémenter. Certaines informations répertoriées dans la documentation générale du fournisseur UI Automation influenceront la façon dont vous implémentez vos homologues et prennent correctement en charge ce modèle. Consultez Implémentation des modèles de contrôle UI Automation et affichez la page qui documente le modèle que vous envisagez d’implémenter.

Modèle de contrôle Interface du fournisseur de classes Description
Annotation IAnnotationProvider Permet d’exposer les propriétés d’une annotation dans un document.
Bassin IDockProvider Utilisées pour les contrôles qui peuvent être ancrés dans un conteneur d’ancrage. Par exemple, les barres d’outils ou les palettes d’outils.
Traîner IDragProvider Utilisé pour prendre en charge les contrôles draggables ou les contrôles avec des éléments pouvant faire glisser.
DropTarget IDropTargetProvider Permet de prendre en charge les contrôles qui peuvent être la cible d’une opération de glisser-déplacer.
ExpandCollapse IExpandCollapseProvider Utilisé pour prendre en charge les contrôles qui s’étendent visuellement pour afficher plus de contenu et réduire pour masquer le contenu.
Grid IGridProvider Utilisées pour les contrôles qui prennent en charge des fonctionnalités de grille telles que le dimensionnement et le déplacement vers une cellule spécifiée. Notez que Grid lui-même n’implémente pas ce modèle, car il fournit une disposition, mais n’est pas un contrôle.
GridItem IGridItemProvider Utilisées pour les contrôles dont les grilles contiennent des cellules.
Appeler IInvokeProvider Utilisé pour les contrôles qui peuvent être appelés, tels qu’un bouton.
ItemContainer IItemContainerProvider Permet aux applications de rechercher un élément dans un conteneur, tel qu’une liste virtualisée.
MultipleView IMultipleViewProvider Utilisées pour les contrôles qui peuvent basculer entre plusieurs représentations du même ensemble d’informations, de données ou d’enfants.
ObjectModel IObjectModelProvider Permet d’exposer un pointeur vers le modèle objet sous-jacent d’un document.
RangeValue IRangeValueProvider Utilisées pour les contrôles disposant d’une plage de valeurs qui peut s’appliquer au contrôle. Par exemple, un contrôle spinner contenant des années peut avoir une plage de 1900 à l’année actuelle, tandis qu’un autre contrôle spinner présentant des mois aurait une plage de 1 à 12.
Faire défiler IScrollProvider Utilisées pour les contrôles qui peuvent défiler. Par exemple, un contrôle disposant de barres de défilement qui sont actives lorsque la quantité d’informations est trop importante pour être affichée dans la zone affichable du contrôle.
ScrollItem IScrollItemProvider Utilisées pour les contrôles qui disposent d’éléments individuels dans une liste déroulante. Par exemple, un contrôle de liste qui dispose d’éléments individuels dans la liste déroulante, comme un contrôle zone de liste déroulante.
Sélection ISelectionProvider Utilisées pour les contrôles conteneur de sélection. Par exemple, ListBox et ComboBox.
SelectionItem ISelectionItemProvider Utilisées pour les éléments individuels dans les contrôles conteneur de sélection, tels que les zones de liste et zones de liste modifiables.
Tableur ISpreadsheetProvider Utilisé pour exposer le contenu d’une feuille de calcul ou d’un autre document basé sur la grille.
SpreadsheetItem ISpreadsheetItemProvider Permet d’exposer les propriétés d’une cellule dans une feuille de calcul ou un autre document basé sur la grille.
Styles IStylesProvider Permet de décrire un élément d’interface utilisateur qui a un style, une couleur de remplissage, un motif de remplissage ou une forme spécifique.
SynchronizedInput ISynchronizedInputProvider Permet aux applications clientes UI Automation de diriger l’entrée de la souris ou du clavier vers un élément d’interface utilisateur spécifique.
Enregistrement ITableProvider Utilisées pour les contrôles qui disposent d’une grille ainsi que d’informations d’en-tête. Par exemple, un contrôle de calendrier tabulaire.
TableItem ITableItemProvider Utilisées pour les éléments d’une table.
Texte ITextProvider Utilisées pour les contrôles d’édition et les documents qui exposent des informations textuelles. Voir aussi ITextRangeProvider et ITextProvider2.
TextChild ITextChildProvider Permet d’accéder à l’ancêtre le plus proche d’un élément qui prend en charge le modèle de contrôle De texte .
TextEdit Aucune classe managée disponible Fournit l’accès à un contrôle qui modifie du texte, par exemple un contrôle qui effectue une correction automatique ou active la composition d’entrée via un éditeur de méthode d’entrée (IME).
TextRange ITextRangeProvider Fournit l’accès à une étendue de texte continu dans un conteneur de texte qui implémente ITextProvider. Voir aussi ITextRangeProvider2.
Bouton à bascule IToggleProvider Utilisées pour les contrôles dont l’état peut être activé et désactivé. Par exemple, CheckBox et les éléments de menu qui peuvent être cochés.
Transformer ITransformProvider Utilisées pour les contrôles qui peuvent être redimensionnés, déplacés et pivotés. Les utilisations courantes du modèle de contrôle Transform se font dans les concepteurs, les formulaires les éditeurs graphiques et les applications de dessin.
Valeur IValueProvider Permet aux clients d’obtenir ou de définir une valeur sur des contrôles qui ne prennent pas en charge une plage de valeurs.
VirtualizedItem IVirtualizedItemProvider Expose des éléments à l’intérieur de conteneurs virtualisés et doivent être rendus entièrement accessibles en tant qu’éléments UI Automation.
Window IWindowProvider Expose des informations spécifiques aux fenêtres, concept fondamental du système d’exploitation Microsoft Windows. Exemples de contrôles qui sont des fenêtres sont des fenêtres enfants et des boîtes de dialogue.

Remarque

Vous ne trouverez pas nécessairement d’implémentations de tous ces modèles dans les contrôles XAML existants. Certains des modèles ont des interfaces uniquement pour prendre en charge la parité avec la définition générale de l’infrastructure UI Automation des modèles et pour prendre en charge les scénarios d’homologue Automation qui nécessitent une implémentation purement personnalisée pour prendre en charge ce modèle.

Remarque

Les applications du Windows Phone Store ne prennent pas en charge tous les modèles de contrôle UI Automation répertoriés ici. Annotation, Dock, Drag, DropTarget, ObjectModel sont certains des modèles non pris en charge.