Instruções passo a passo: demonstrando herança visual

Artigo
06/02/2023

A herança visual permite que você veja os controles no formulário de base e adicione novos controles. Neste passo a passo, você criará um formulário de base e o compilará em uma biblioteca de classes. Você importará esta biblioteca de classes em outro projeto e criará um novo formulário que herda do formulário de base. Durante este passo a passo, você aprenderá a:

Criar um projeto de biblioteca de classes que contém um formulário de base.
Adicionar um botão com propriedades que as classes derivadas do formulário de base podem modificar.
Adicionar um botão que não pode ser modificado por herdeiros do formulário de base.
Criar um projeto que contém um formulário que herda de BaseForm.

Por fim, este passo a passo demonstrará a diferença entre controles particulares e protegidos em um formulário herdado.

Cuidado

Nem todos os controles dão suporte à herança visual de um formulário de base. Os seguintes controles não dão suporte ao cenário descrito neste passo a passo:

Esses controles no formulário herdado sempre são somente leitura, independentemente dos modificadores que você usar (private, protected ou public).

Criar um projeto de biblioteca de classes contendo um formulário base

No Visual Studio, no menu Arquivo, escolha Novo Projeto para abrir a caixa de diálogo Novo>Projeto.
Crie um aplicativo dos Windows Forms chamado BaseFormLibrary.
Para criar uma biblioteca de classes em vez de um aplicativo padrão dos Windows Forms, no Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto BaseFormLibrary e, em seguida, selecione Propriedades.
Nas propriedades do projeto, altere o Tipo de saída de Aplicativo do Windows para Biblioteca de Classes.
No menu Arquivo, escolha Salvar Tudo para salvar o projeto e os arquivos no local padrão.

Os dois procedimentos seguintes adicionam botões ao formulário de base. Para demonstrar a herança visual, você dará aos botões diferentes níveis de acesso configurando suas propriedades Modifiers.

Adicionar um botão que os herdeiros do formulário base podem modificar

Abra Form1 no designer.
Na guia Todos os Windows Forms da Caixa de Ferramentas, clique duas vezes em Botão para adicionar um botão ao formulário. Use o mouse para posicionar e redimensionar o botão.
Na janela Propriedades, defina as seguintes propriedades do botão:
- Defina a propriedade Texto como Say Hello.
- Defina a propriedade (Nome) como btnProtected.
- Defina a propriedade Modifiers como Protected. Isso possibilita que formulários que herdam de Form1 modifiquem as propriedades de btnProtected.
Clique duas vezes no botão Say Hello para adicionar um manipulador de eventos para o evento Clique.

Adicione a seguinte linha de código ao manipulador de eventos:

MessageBox.Show("Hello, World!")

MessageBox.Show("Hello, World!");

Adicionar um botão que não pode ser modificado pelos herdeiros do formulário base

Passe para o modo de exibição de Design clicando na guia Form1.vb [Design], Form1.cs [Design] ou Form1.jsl [Design] acima do editor de código ou pressionando F7.
Adicione um segundo botão e defina suas propriedades da seguinte maneira:
- Defina a propriedade Texto como Say Goodbye.
- Defina a propriedade (Nome) como btnPrivate.
- Defina a propriedade (Nome) como Particular. Isso possibilita que formulários que herdam de Form1 modifiquem as propriedades de btnPrivate.
Clique duas vezes no botão Say Goodbye para adicionar um manipulador de eventos para o evento Clique. Coloque a seguinte linha de código no procedimento do evento:
```
MessageBox.Show("Goodbye!")
```
```
MessageBox.Show("Goodbye!");
```
Do menu Compilação, escolha Compilar Biblioteca de BaseForm para compilar a biblioteca de classes.

Após a biblioteca ter sido compilada, você pode criar um novo projeto que herda do formulário que você acabou de criar.

Criar um projeto que contém um formulário que herda do formulário base

No menu Arquivo, escolha Adicionar e selecione Novo Projeto para abrir a caixa de diálogo Adicionar Novo Projeto.
Crie um aplicativo dos Windows Forms chamado InheritanceTest.

Adicionar um formulário herdado

No Gerenciador de Soluções, clique com o botão direito do mouse no projeto InheritanceTest , selecione Adicionar e Novo Item.
Na caixa de diálogo Adicionar Novo Item, selecione a categoria Windows Forms (se você tiver uma lista de categorias) e selecione o modelo Formulário Herdado.
Deixe o nome padrão Form2 e clique em Adicionar.
Na caixa de diálogo Selecionador de Herança, selecione Form1 do projeto BaseFormLibrary como o formulário do qual herdar e clique em OK.

Isso cria um formulário no projeto InheritanceTest que deriva de formulário em BaseFormLibrary.
Abra o formulário herdado (Form2) no designer clicando duas vezes nele, se ele ainda não estiver aberto.

No designer, os botões herdados têm um símbolo () em seu canto superior, indicando que são herdados.
Selecione o botão Say Hello e observe as alças de redimensionamento. Como esse botão é protegido, os herdeiros podem movê-lo, redimensioná-lo, alterar sua legenda e fazer outras modificações.
Selecione o botão particular Say Goodbye e observe que ele não tem alças de redimensionamento. Além disso, na janela Propriedades, as propriedades deste botão ficam cinza para indicar que não podem ser modificadas.
Se você estiver usando o Visual C#:
1. No Gerenciador de Soluções, clique com o botão direito do mouse em Form1 no projeto InheritanceTest e selecione Excluir. Na caixa de mensagem que aparece, clique em OK para confirmar a exclusão.
2. Abra o arquivo Program.cs e altere a linha Application.Run(new Form1()); para Application.Run(new Form2());.
No Gerenciador de Soluções, clique com o botão direito do mouse no projeto InheritanceTest e selecione Definir como projeto de inicialização.
No Gerenciador de Soluções, clique com o botão direito do mouse no projeto InheritanceTest e selecione Propriedades.
Na página de propriedades de InheritanceTest, defina o Objeto de Inicialização para ser o formulário herdado (Form2).
Pressione F5 para executar o aplicativo e observe o comportamento do formulário herdado.

Próximas etapas

A herança para controles de usuário funciona basicamente da mesma forma. Abra um novo projeto de biblioteca de classes e adicione um controle de usuário. Coloque os controles constituintes nele e compile o projeto. Abra outro novo projeto de biblioteca de classes e adicione uma referência à biblioteca de classes compilada. Além disso, tente adicionar um controle herdado (por meio da caixa de diálogo Adicionar Novos Itens) ao projeto e usar o Selecionador de Herança. Adicione um controle de usuário e altere a Inherits instrução (: no Visual C#). Para mais informações, consulte Como herdar Windows Forms.

Compartilhar via