Como: Expor propriedades de 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.Para disponibilizar propriedades desses controles para futuros usuários, você deve expor-los para o usuário.Uma propriedade de um controle constituinte é exposta, criar uma propriedade no controle de usuário e, usando o get e set acessadores de propriedade para efetivar a alterar de propriedade particular do controle constituinte.

Considere a possibilidade de um controle de usuário hipotéticos com o botão constituinte chamado MyButton. Neste exemplo, quando o usuário solicita a ConstituentButtonBackColor propriedade, o valor armazenado na BackColor propriedade de MyButton é entregue. Quando o usuário atribui um valor para essa propriedade, que 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 seu controle de usuário.

  2. No get seção da propriedade, gravar código recupera o valor da propriedade você deseja expor.

  3. No set seção da propriedade, e escrevea o código que passa o valor da propriedade para a propriedade exposta do controle constituinte.

Consulte também

Conceitos

Variedades de controles personalizados

Referência

UserControl

Outros recursos

Propriedades em controles Windows Forms