Partager via

Implémentation du modèle de contrôle Dock d’UI Automation

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 présente des instructions et des conventions pour l’implémentation IDockProvider, y compris des informations sur les propriétés. Les liens vers des références supplémentaires sont répertoriés à la fin de la rubrique.

Le modèle de contrôle DockPattern est utilisé pour exposer les propriétés de l’ancrage d’un contrôle dans un conteneur d’ancrage. Un conteneur d’ancrage est un contrôle qui vous permet de réorganiser des éléments enfants horizontalement et verticalement, les uns par rapport aux autres. Pour obtenir des exemples de contrôles qui implémentent ce modèle de contrôle, consultez Mappage des modèles de contrôle pour les clients UI Automation.

Conteneur d’ancrage avec deux enfants ancrés. Exemple d’ancrage à partir de Visual Studio où la fenêtre « Vue de classe » est DockPosition.Right et « Liste d’erreurs » est DockPosition.Bottom

Directives et conventions de mise en œuvre

Lors de l’implémentation du modèle de contrôle Dock, notez les instructions et conventions suivantes :

  • IDockProvider n’expose aucune propriété du conteneur d’ancrage ni aucune propriété de contrôles ancrés adjacents au contrôle actuel dans le conteneur d’ancrage.

  • Les contrôles sont ancrés les uns par rapport aux autres en fonction de leur ordre z actuel ; plus leur positionnement par ordre z est élevé, plus ils sont placés à partir du bord spécifié du conteneur d’ancrage.

  • Si le conteneur d’ancrage est redimensionné, tous les contrôles ancrés au sein du conteneur sont repositionnés sur le même bord sur lequel ils ont été initialement ancrés. Les contrôles ancrés sont également redimensionnés pour remplir tout l’espace du conteneur d’après le comportement d’ancrage de leur DockPosition. Par exemple, si Top est spécifié, les côtés gauche et droit de l'élément de contrôle s'étendent pour remplir tout espace disponible. Si Fill est spécifié, les quatre côtés du contrôle s’étendent pour remplir tout espace disponible.

  • Sur un système à plusieurs moniteurs, les contrôles doivent s’ancrer à gauche ou à droite du moniteur actuel. Si cela n’est pas possible, ils doivent s’ancrer sur le côté gauche du moniteur le plus à gauche ou sur le côté droit du moniteur le plus à droite.

Membres requis pour IDockProvider

Les propriétés et méthodes suivantes sont requises pour implémenter l’interface IDockProvider.

Membres obligatoires Type de membre Remarques
DockPosition Propriété Aucun
SetDockPosition Méthode Aucun

Ce modèle de contrôle n’a aucun événement associé.

Exceptions

Les fournisseurs doivent lever les exceptions suivantes.

Type d’exception État
InvalidOperationException SetDockPosition

- Lorsqu’un contrôle n’est pas en mesure d’exécuter le style d’ancrage demandé.

Voir aussi