Compartilhar via

Como expor propriedades de controles constituintes

  • Artigo

Os controles que compõem um controle composto são chamados controles constituintes. Esses controles normalmente são declarados privados e, portanto, não podem ser acessados pelo desenvolvedor. Se você quiser disponibilizar as propriedades desses controles para os usuários futuros, deverá expô-las ao usuário. Uma propriedade de um controle constituinte é exposta criando uma propriedade no controle do usuário e usando os acessadores get e set dessa propriedade para efetuar a alteração na propriedade privada do controle constituinte.

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

O exemplo a seguir mostra como expor a propriedade BackColor 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;
   }
}

Para expor uma propriedade de um controle componente

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

  2. Na seção de propriedade get, escreva o código que obtenha o valor da propriedade que você deseja expor.

  3. Na seção set da propriedade, escreva o código para transferir o valor da propriedade para a propriedade exposta do controle componente.

Consulte também