Aplicação de exemplo WinForms

Este exemplo, WebView2WindowsFormsBrowser, demonstra como utilizar o controlo WebView2 e as APIs WebView2 para implementar um browser numa aplicação WinForms.

• Nome de exemplo: WebView2WindowsFormsBrowser
• Diretório de repositório: WebView2WindowsFormsBrowser
• Ficheiro de solução: WebView2WindowsFormsBrowser.sln

• O menu Controlo tem menuitems de alternar para Chaves de Acelerador e Permitir Queda Externa.
• O menu Ver tem submenus Zoom e Cor de Fundo .
• O botão Eventos abre a janela EventMonitor .

Passo 1 – Instalar o Visual Studio

É necessário o Microsoft Visual Studio. O Microsoft Visual Studio Code não é suportado para este exemplo.

1. Se o Visual Studio (versão mínima necessária) ainda não estiver instalado, numa janela ou separador separador, consulte Instalar o Visual Studio em Configurar o ambiente de Programador para WebView2. Siga os passos nessa secção e, em seguida, regresse a esta página e continue os passos abaixo.

Passo 2 – Clonar ou transferir o repositório WebView2Samples

1. Se ainda não tiver terminado, clone ou transfira o WebView2Sample repositório para a unidade local. Numa janela ou separador separador, consulte Transferir o repositório WebView2Samples em Configurar o ambiente de Programador para WebView2. Siga os passos nessa secção e, em seguida, regresse a esta página e continue abaixo.

Passo 3 – Abrir .sln no Visual Studio

1. Na unidade local, abra o .sln ficheiro no Visual Studio, no diretório :

   • <your-repos-directory>/WebView2Samples/SampleApps/WebView2WindowsFormsBrowser/WebView2WindowsFormsBrowser.sln

   ou:

   • <your-repos-directory>/WebView2Samples-main/SampleApps/WebView2WindowsFormsBrowser/WebView2WindowsFormsBrowser.sln

Passo 4 – Instalar cargas de trabalho, se lhe for pedido

1. Se lhe for pedido, instale quaisquer cargas de trabalho do Visual Studio pedidas. Numa janela ou separador separador, consulte Instalar cargas de trabalho do Visual Studio em Configurar o ambiente Dev para WebView2. Siga os passos nessa secção e, em seguida, regresse a esta página e continue abaixo.

Passo 5 – Compilar e executar o projeto

O projeto WebView2WindowsFormsBrowser está agora aberto no Visual Studio, a partir dos passos acima. Na parte superior do Visual Studio, defina o destino da criação da seguinte forma:

1. Na lista pendente Configurações de Soluções , selecione Depurar ou Versão.

2. Na lista pendente Plataformas de Soluções , selecione Qualquer CPU.

3. No Explorador de Soluções, clique com o botão direito do rato no projeto WebView2WindowsFormsBrowser e, em seguida, selecione Compilar.

   Esta ação cria o ficheiro SampleApps/WebView2WindowsFormsBrowser/WebView2WindowsFormsBrowser.vcxprojde projeto . Esta operação pode demorar alguns minutos.

   Se receber mensagens de erro sobre o .NET Framework 4.6.2 Developer Pack em falta, siga os passos abaixo. Caso contrário, avance para a próxima secção principal abaixo.

4. No Visual Studio, selecione Depurar>Iniciar Depuração (F5).

   É aberta a janela da aplicação de exemplo:

   

5. Utilizar a aplicação de exemplo; consulte Ficheiro README para WebView2WindowsFormsBrowser.

6. No Visual Studio, selecione Depurar>Parar Depuração. O Visual Studio fecha a aplicação.

Passo 6 – Instalar o .NET Framework 4.6.2 Developer Pack

Se criar o projeto WebView2WindowsFormsBrowser e receber mensagens de erro sobre o .NET Framework 4.6.2 Developer Pack em falta, siga os passos abaixo. Caso contrário, avance para a próxima secção principal abaixo.

1. Aceda a Transferir .NET Framework, selecione v4.6.2 e, em seguida, clique no botão Transferir .NET Framework 4.6.2 Developer Pack :

   

2. No Microsoft Edge, selecione Definições e mais>Transferências>Mostrar na pasta ícone:

   

3. Downloads Na pasta, faça duplo clique no ficheiro, como ndp462-devpack-kb3151934-enu.exe.

   É apresentada a caixa de diálogo Contrato de licença do Microsoft .NET Framework Developer Pack :

   

4. Selecione a caixa de verificação Concordo com os termos e condições da licença e, em seguida, clique no botão Instalar .

   É apresentada uma janela Controlo de Conta de Utilizador a perguntar "Pretende permitir que esta aplicação faça alterações ao seu dispositivo?"

5. Clique no botão Sim .

   É apresentada a caixa de diálogo Configuração com Êxito do Pacote de Programador do Microsoft .NET Framework:

   

6. Clique no botão Fechar .

O Microsoft .NET Framework 4.6.2 Developer Pack está agora instalado no seu computador.

Passo 7 – Atualizar ou instalar o SDK WebView2

1. SDK WebView2 – atualize ou instale o SDK WebView2 no nó do projeto (não o nó da solução) no Explorador de Soluções. Numa janela ou separador separador, consulte Instalar ou atualizar o SDK WebView2 em Configurar o ambiente Dev para WebView2. Siga os passos nessa secção e, em seguida, regresse a esta página e continue abaixo.

   

Passo 8 – Compilar e executar o projeto atualizado

1. Se acabou de instalar o .NET Framework 4.6.2 Developer Pack acima, feche o Visual Studio e, em seguida, abra novamente o ficheiro de solução no Visual Studio, a partir do diretório:

   • <your-repos-directory>/WebView2Samples/SampleApps/WebView2WindowsFormsBrowser/WebView2WindowsFormsBrowser.sln

   ou:

   • <your-repos-directory>/WebView2Samples-main/SampleApps/WebView2WindowsFormsBrowser/WebView2WindowsFormsBrowser.sln

Na parte superior do Visual Studio, defina o destino da criação da seguinte forma:

1. Na lista pendente Configurações de Soluções , selecione Depurar ou Versão.

2. Na lista pendente Plataformas de Soluções , selecione Qualquer CPU.

3. No Explorador de Soluções, clique com o botão direito do rato no projeto WebView2WindowsFormsBrowser e, em seguida, selecione Compilar.

   Esta ação cria o ficheiro SampleApps/WebView2WindowsFormsBrowser/WebView2WindowsFormsBrowser.vcxprojde projeto .

4. No Visual Studio, selecione Depurar>Iniciar Depuração (F5).

   É aberta a janela da aplicação de exemplo:

   

   • O menu Controlo tem menuitems de alternar para Chaves de Acelerador e Permitir Queda Externa.
   • O menu Ver tem submenus Zoom e Cor de Fundo .
   • O botão Eventos abre a janela EventMonitor .

5. No Visual Studio, selecione Depurar>Parar Depuração. O Visual Studio fecha a aplicação.

Passo 9 – Inspecionar o código

1. No editor de código do Visual Studio, inspecione o código:

   

Confira também

• Referência da API webView2
• Introdução ao WebView2 em aplicações WinForms