Comment : exposer les propriétés des contrôles constitutifs

  • Article

Les contrôles qui composent un contrôle composite sont appelés contrôles constituants. Ces contrôles sont normalement déclarés privés et ne sont donc pas accessibles par le développeur. Si vous souhaitez rendre les propriétés de ces contrôles disponibles pour les futurs utilisateurs, vous devez les exposer à l’utilisateur. Une propriété d’un contrôle constituant est exposée en créant une propriété dans le contrôle utilisateur et en utilisant les accesseurs et set les get accesseurs de cette propriété pour appliquer la modification de la propriété privée du contrôle constituant.

Considérez un contrôle utilisateur hypothétique avec un bouton constituant nommé MyButton. Dans cet exemple, lorsque l’utilisateur demande la ConstituentButtonBackColor propriété, la valeur stockée dans la BackColor propriété de celle-ci MyButton est remise. Lorsque l’utilisateur affecte une valeur à cette propriété, cette valeur est automatiquement transmise à la BackColor propriété et MyButton le set code s’exécute, en modifiant la couleur de MyButton.

L’exemple suivant montre comment exposer la BackColor propriété du bouton constituant :

Public Property ButtonColor() as System.Drawing.Color
   Get
      Return MyButton.BackColor
   End Get
   Set(Value as System.Drawing.Color)
      MyButton.BackColor = Value
   End Set
End Property

public Color ButtonColor
{
   get
   {
      return(myButton.BackColor);
   }
   set
   {
      myButton.BackColor = value;
   }
}

Pour exposer une propriété d’un contrôle constituant

  1. Créez une propriété publique pour votre contrôle utilisateur.

  2. Dans la get section de la propriété, écrivez du code qui récupère la valeur de la propriété à exposer.

  3. Dans la set section de la propriété, écrivez du code qui transmet la valeur de la propriété à la propriété exposée du contrôle constituant.

Voir aussi