Início rápido para WPF

Este guia mostra como começar a trabalhar com o DotNetBrowser e incorporá-lo numa aplicação WPF simples.

Antes de começar, certifique-se de que o seu sistema cumpre os requisitos de software e hardware.

1. Crie uma aplicação WPF

Crie um novo projeto Embedding.Wpf WPF Application C# Project ou WPF Application Visual Basic Project:

2. Adicionar o DotNetBrowser ao projeto

No Explorador de Soluções, clique com o botão direito do mouse em Referências e selecione a opção Gerenciar Pacotes NuGet:

Escolha “nuget.org” como Fonte do pacote, selecione a aba Explorar, procure “DotNetBrowser”, selecione o pacote DotNetBrowser.Wpf e clique em Instalar:

Aceite o pedido de licença para continuar a instalação.

3. Altere o código fonte

Insira o seguinte código no arquivo MainWindow.xaml:

<Window
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    xmlns:WPF="clr-namespace:DotNetBrowser.Wpf;assembly=DotNetBrowser.Wpf"
    x:Class="Embedding.Wpf.MainWindow"
    mc:Ignorable="d"
    Title="MainWindow" Height="480" Width="800" Closed="Window_Closed">
    <Grid>
        <WPF:BrowserView Name="browserView" />
    </Grid>
</Window>

Utilize o exemplo de código abaixo para o arquivo MainWindow.xaml.cs MainWindow.xaml.vb:

using System;
using System.Windows;
using DotNetBrowser.Browser;
using DotNetBrowser.Engine;

namespace Embedding.Wpf
{
    /// <summary>
    /// Este exemplo demonstra como incorporar o DotNetBrowser
    /// numa aplicação WPF.
    /// </summary>
    public partial class MainWindow : Window
    {
        private const string Url = "https://html5test.teamdev.com/";
        private readonly IBrowser browser;
        private readonly IEngine engine;

        public MainWindow()
        {
            // Cria e inicializa a instância IEngine.
            EngineOptions engineOptions = new EngineOptions.Builder
            {
                RenderingMode = RenderingMode.HardwareAccelerated
            }.Build();
            engine = EngineFactory.Create(engineOptions);

            // Cria a instância do IBrowser.
            browser = engine.CreateBrowser();

            InitializeComponent();

            // Inicializa o controle BrowserView do WPF.
            browserView.InitializeFrom(browser);
            browser.Navigation.LoadUrl(Url);
        }

        private void Window_Closed(object sender, EventArgs e)
        {
            browser?.Dispose();
            engine?.Dispose();
        }
    }
}

Imports System.Windows
Imports DotNetBrowser.Browser
Imports DotNetBrowser.Engine

Namespace Embedding.Wpf
    ''' <summary>
    '''     Este exemplo demonstra como incorporar o DotNetBrowser
    '''     em uma aplicação a WPF.
    ''' </summary>
    Partial Public Class MainWindow
        Inherits Window

        Private Const Url As String = "https://html5test.teamdev.com/"
        Private ReadOnly browser As IBrowser
        Private ReadOnly engine As IEngine

        Public Sub New()
            ' Cria e inicializa a instância IEngine.
            Dim engineOptions As EngineOptions = New EngineOptions.Builder With {
                .RenderingMode = RenderingMode.HardwareAccelerated
            }.Build()
            engine = EngineFactory.Create(engineOptions)

            ' Cria a instância do IBrowser.
            browser = engine.CreateBrowser()

            InitializeComponent()

            ' Inicializa o controle BrowserView do WPF.
            browserView.InitializeFrom(browser)
            browser.Navigation.LoadUrl(Url)
        End Sub

        Private Sub Window_Closed(sender As Object, e As EventArgs)
            browser?.Dispose()
            engine?.Dispose()
        End Sub
    End Class
End Namespace

O projeto completo está disponível no nosso repositório: C#, VB.

4. Obter licença de teste

Para obter uma licença de avaliação gratuita de 30 dias, preencha o formulário Web e clique no botão Obter uma avaliação gratuita. Você receberá um email com a chave de licença.

5. Adicione uma licença

Para incorporar a chave de licença no seu projeto, copie o código da chave de licença do e-mail e a insira como indicado abaixo:

EngineOptions engineOptions = new EngineOptions.Builder
{
    RenderingMode = RenderingMode.HardwareAccelerated,
    LicenseKey = "sua_chave_de_licença"
}.Build();

Dim engineOptions As EngineOptions = New EngineOptions.Builder With {
    .RenderingMode = RenderingMode.HardwareAccelerated,
    .LicenseKey = "sua_chave_de_licença"
}.Build()

Para obter mais informações sobre a instalação da licença, consulte este artigo.

6. Execute a aplicação

Para executar a aplicação, aperte F5 ou clique no botão Começar na barra de ferramentas. A Janela Principal abrirá: