Visão geral do controle de 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 é chamado de controle composto. Os controles contidos são chamados controles constituintes. Os controles de usuário derivam da UserControl classe.

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á criando um formulário. O controle de usuário é colocado em um formulário 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 tenham referência à biblioteca do controle de usuário.

Importante

A documentação do Guia da Área de Trabalho para .NET 7 e .NET 6 está em construção.

Controles constituintes

Os controles constituintes estão disponíveis para o controle de usuário e o usuário do aplicativo pode interagir com todos eles individualmente em tempo de execução, mas as propriedades e os métodos declarados pelos controles constituintes não são expostos ao consumidor. Por exemplo, se você colocar um TextBox controle e Button no controle de usuário, o evento do Click botão será manipulado internamente pelo controle de usuário, mas não pelo formulário onde o controle de 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 Project Explorer . 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 seu controle de usuário. 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 em funcionamento, consulte Como criar um controle de usuário.