Visão geral do controle do usuário (Windows Forms .NET)

Um controle de usuário é uma coleção de controles do Windows Forms encapsulados em um contêiner comum. Esse tipo de controle é conhecido como um controle composto . Os controles contidos são chamados controles constituintes. Os controles de usuário derivam da classe UserControl.

Os controles de usuário são projetados como Formulários, com um designer visual. Você cria, organiza e modifica os controles constituintes por meio do designer visual. Os eventos de controle e a lógica são gravados exatamente da mesma maneira que quando você está projetando um Formulário. O controle de usuário é colocado em um Formulário, assim como qualquer outro controle.

Os controles de usuário são utilizáveis pelo projeto no qual são criados ou em outros projetos que têm referência à biblioteca do controle de usuário.

Controles dos componentes

Os controles constituintes estão disponíveis para o controle do usuário e o usuário do aplicativo pode interagir com todos eles individualmente em runtime, mas as propriedades e os métodos declarados pelos controles constituintes não são expostos ao consumidor. Por exemplo, se você colocar um controle TextBox e Button no controle do usuário, o evento Click do botão será tratado internamente pelo controle do usuário, mas não pelo Formulário em que o controle do usuário é colocado.

Adicionar um controle de usuário a um projeto

Depois de criar um novo projeto, use os modelos do Visual Studio para criar um controle de usuário. As etapas a seguir demonstram como adicionar um controle de usuário ao seu projeto:

1. No Visual Studio, localize o painel Gerenciador de Projetos. Clique com o botão direito do mouse no projeto e escolha Adicionar>Controle de Usuário (Windows Forms).

   

2. Na caixa Nome, digite um nome para o controle de usuário. O Visual Studio fornece um nome padrão e exclusivo que você pode usar. Em seguida, pressione Adicionar.

   

Depois que o controle de usuário é criado, o Visual Studio abre o designer:

Para obter um exemplo de um controle de usuário funcional, consulte Como criar um controle de usuário.