Como: Expor as propriedades dos controles constituintes

Os controles que compõem um controle composto são chamados de controles constituintes. Esses controles são normalmente declarados particulares e, portanto, não podem ser acessados pelo desenvolvedor. Se você quiser disponibilizar as propriedades desses controles para futuros usuários, você deve expor-los para o usuário. Uma propriedade de um controle constituinte é exposta a criação de uma propriedade no controle de usuário e, em seguida, usando o get e set acessadores dessa propriedade para efetivar a alteração na propriedade particular do controle constituintes.

Considere um controle de usuário hipotético com um botão constituinte chamado MyButton. Neste exemplo, quando o usuário solicita a ConstituentButtonBackColor propriedade, o valor armazenado nas BackColor propriedade de MyButton é entregue. Quando o usuário atribui um valor para essa propriedade, esse valor é transmitido automaticamente para o BackColor propriedade de MyButton e o set código será executado, alterando a cor de MyButton.

O exemplo a seguir mostra como expor o BackColor propriedade do botão constituinte:

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);
}

Para expor uma propriedade de um controle constituinte

  1. Crie uma propriedade pública para o controle de usuário.

  2. No get seção da propriedade, escrever um código que recupera o valor da propriedade que você deseja que a exposição.

  3. No set seção da propriedade, escrever um código que passa o valor da propriedade para a propriedade exposta do controle constituintes.

Consulte também

Referência

UserControl

Conceitos

Variedades de controles personalizados

Outros recursos

Propriedades de controles do Windows Forms