Modèle de contrôle d’ancrage

  • Article

Décrit des instructions et des conventions pour l’implémentation d’IDockProvider, y compris des informations sur les propriétés et les méthodes. Le modèle de contrôle Dock est utilisé pour exposer les propriétés d’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. L’image suivante montre un conteneur d’ancrage avec deux éléments enfants. Pour obtenir des exemples de contrôles qui implémentent ce modèle de contrôle, consultez Types de contrôles et leurs modèles de contrôle pris en charge.

capture d’écran montrant le conteneur d’ancrage avec deux enfants ancrés

Cette rubrique contient les sections suivantes.

Conventions et directives d'implémentation

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

  • IDockProvider n’expose aucune propriété du conteneur d’ancrage ni aucune propriété des contrôles ancrés à côté du 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 sont également redimensionnés pour remplir l’espace dans le conteneur en fonction du comportement d’ancrage de leur propriété DockPosition . Par exemple, si DockPosition_Top est spécifié, les côtés gauche et droit du contrôle se développent pour remplir l’espace disponible. Si DockPosition_Fill est spécifié, les quatre côtés du contrôle se développent 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 actif. 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.

Membres requis pour IDockProvider

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

Membres nécessaires Type de membre Notes
DockPosition Propriété Aucun
SetDockPosition Méthode Aucun

 

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

Types de contrôles et leurs modèles de contrôle pris en charge

Vue d'ensemble des modèles de contrôle UI Automation

Vue d’ensemble de l’arborescence UI Automation