Partilhar via


Como expor as propriedades de controles constituintes

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

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

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

Para expor uma propriedade de um controle de membro

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

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

  3. Na seção set da propriedade, escreva o código que passa o valor da propriedade para a propriedade exposta do controle de membro.

Confira também