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

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 présente les conventions et instructions à respecter pour implémenter IDockProvider, notamment les informations sur les propriétés. Des 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 de modèle de contrôle pour les clients UI Automation.

Exemple d'ancrage de Visual Studio où la fenêtre "Affichage de classes" est DockPosition.Right et la fenêtre "Liste d'erreurs" est DockPosition.Bottom

Conteneur d'ancrage avec deux enfants ancrés

Cette rubrique comprend les sections suivantes.

Conventions et instructions d'implémentation
Membres requis pour IDockProvider
Exceptions
Rubriques connexes

Conventions et instructions d'implémentation

Lorsque vous implémentez le modèle de contrôle Dock, notez les conventions et instructions suivantes :

IDockProvider n'expose aucune propriété du conteneur d'ancrage ni aucune propriété des contrôles qui sont ancrés de façon à être adjacents au contrôle actuel dans le conteneur d'ancrage.
Les contrôles sont ancrés les uns par rapport aux autres selon leur ordre de plan actuel ; plus leur positionnement dans l'ordre de plan est haut, plus ils sont placés loin du bord spécifié du conteneur d'ancrage.
Si le conteneur d'ancrage est redimensionné, tout contrôle ancré dans le conteneur est repositionné sur le même bord que celui auquel il était ancré à l'origine. Les contrôles ancrés seront également redimensionnés pour remplir tout 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 du contrôle seront développés pour remplir l'espace disponible. Si Fill est spécifié, les quatre côtés du contrôle seront développés pour remplir l'espace disponible.
Sur un système à écrans multiples, les contrôles doivent être ancrés au côté gauche ou droit de l'écran actuel. Si ce n'est pas possible, ils doivent être ancrés au côté gauche de l'écran le plus à gauche ou au côté droit de l'écran le plus à droite.