Comment : exposer les propriétés des contrôles constitutifs
Les contrôles qui composent un contrôle composite sont appelés contrôles constitutifs. Ces contrôles sont normalement déclarés privés, si bien qu'ils ne sont pas accessibles par le développeur. Pour mettre à la disposition des futurs utilisateurs certaines propriétés de ces contrôles, vous devez les exposer à l'utilisateur. Pour exposer une propriété de contrôle constitutif, créez une propriété dans le contrôle utilisateur et utilisez ses accesseurs get et set pour répercuter la modification dans la propriété privée du contrôle constitutif.
Prenons l'exemple d'un contrôle utilisateur hypothétique doté d'un bouton constitutif appelé MyButton. Dans cet exemple, lorsque l'utilisateur demande la propriété ConstituentButtonBackColor, la valeur enregistrée dans la propriété BackColor de MyButton est retournée. Lorsque l'utilisateur assigne une valeur à cette propriété, cette valeur est automatiquement passée à la propriété BackColor de MyButton, après quoi le code set s'exécute et modifie la couleur de MyButton.
L'exemple suivant montre comment exposer la propriété BackColor du bouton constitutif :
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;
}
}
/** @property */
public Color get_ButtonColor()
{
return myButton.get_BackColor();
}
/** @property */
public void set_ButtonColor(Color value)
{
myButton.set_BackColor(value);
}
Pour exposer une propriété d'un contrôle constitutif
Créez une propriété publique pour votre contrôle utilisateur.
Dans la section get de la propriété, écrivez un code qui récupère la valeur de la propriété à exposer.
Dans la section set de la propriété, écrivez du code pour passer la valeur de la propriété à la propriété exposée du contrôle constitutif.
Voir aussi
Référence
Concepts
Variétés de contrôles personnalisés