Avalonia C# (Como funciona para desenvolvedores)

Configurando seu ambiente de desenvolvimento

Para começar a desenvolver com Avalonia, você precisa configurar seu ambiente de desenvolvimento. Você pode usar o Visual Studio ou o JetBrains Rider como sua IDE. Primeiro, instale o Visual Studio ou o JetBrains Rider. Em seguida, adicione a extensão Avalonia para Visual Studio ao seu ambiente de desenvolvimento integrado (IDE). Essa extensão fornece modelos de projeto e um visualizador de XAML. Isso melhora sua experiência de desenvolvimento.

Para quem está migrando de projetos WPF multiplataforma, o Avalonia C# oferece um processo de desenvolvimento familiar, com acesso a links externos e recursos suportados pela .NET Foundation.

Sua primeira inscrição na Avalonia

Criar sua primeira aplicação Avalonia é muito simples. Abra seu ambiente de desenvolvimento integrado (IDE) e selecione o modelo de projeto Avalonia. Isso cria um novo projeto com a configuração padrão do Avalonia. O projeto inclui uma janela principal e uma configuração básica. Execute o projeto para ver sua primeira aplicação Avalonia em ação. Você acaba de iniciar sua jornada com Avalonia C#.

Entendendo a interface do usuário e o XAML do Avalonia

A interface de usuário do Avalonia UI utiliza XAML. XAML é uma linguagem de marcação que define os elementos da interface do usuário. Aqui está um exemplo simples de XAML em uma aplicação Avalonia:

<Window xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="Avalonia Example">
    <TextBlock Text="Hello, Avalonia!" HorizontalAlignment="Center" VerticalAlignment="Center"/>
</Window>

<Window xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="Avalonia Example">
    <TextBlock Text="Hello, Avalonia!" HorizontalAlignment="Center" VerticalAlignment="Center"/>
</Window>

Este código cria uma janela com um bloco de texto no centro. O bloco de texto exibe "Olá, Avalônia!". O XAML facilita o design e o ajuste da sua interface de usuário.

Modelos de estilo e controle

Avalonia se destaca por oferecer um sistema de estilização flexível e por atender a uma ampla gama de necessidades de design. Este sistema permite que você defina a aparência e o funcionamento do seu aplicativo. Você pode personalizar os modelos de controle para obter um design consistente. Eis como você pode definir um estilo simples para um botão:

<Window.Styles>
    <Style Selector="Button">
        <Setter Property="Background" Value="#007ACC"/>
        <Setter Property="Foreground" Value="White"/>
    </Style>
</Window.Styles>

<Window.Styles>
    <Style Selector="Button">
        <Setter Property="Background" Value="#007ACC"/>
        <Setter Property="Foreground" Value="White"/>
    </Style>
</Window.Styles>

Este estilo altera a cor de fundo e a cor do texto de todos os botões na janela. O sistema de estilização do Avalonia suporta cenários complexos, incluindo temas e animações.

Trabalhando com dados e controles

A vinculação de dados no Avalonia permite a conexão da sua interface de usuário às suas fontes de dados. Aqui está um exemplo básico de vinculação de dados:

<TextBox Text="{Binding UserName}"/>

<TextBox Text="{Binding UserName}"/>

Este código vincula a propriedade Text do TextBox a uma propriedade UserName no seu contexto de dados. Avalonia oferece suporte a uma ampla variedade de controles para diferentes finalidades, como ListBox , DataGrid e TreeView .

Introdução ao IronPDF

Visão geral da biblioteca IronPDF : trata-se de uma biblioteca .NET que facilita muito o trabalho com PDFs. Permite aos desenvolvedores criar, editar e extrair conteúdo de PDFs programaticamente. Uma das funcionalidades mais marcantes do IronPDF é a sua capacidade de converter HTML em IronPDF , tornando-o incrivelmente útil para gerar relatórios, faturas ou qualquer documento que possa ser renderizado como uma página da web.

Caso de uso: Integrando o IronPDF com o Avalonia C

Imagine que você está desenvolvendo um aplicativo para desktop com Avalonia que precisa gerar faturas em formato PDF. Seu aplicativo possui um modelo de fatura em HTML com um design excelente, e você deseja preencher os detalhes dinamicamente e salvá-lo como PDF. É aí que o IronPDF entra em ação. Ao integrar o IronPDF, você pode renderizar seu modelo de fatura HTML com os dados preenchidos e salvá-lo diretamente do seu aplicativo Avalonia.

Exemplo de código: Gerando uma fatura em PDF

A seguir, apresentamos um exemplo completo que demonstra como você pode implementar essa funcionalidade. Vamos criar uma janela simples do Avalonia com um botão. Ao clicar no botão, um PDF é gerado a partir de uma string HTML (que servirá como nosso modelo de fatura) e salvo no seu computador.

Primeiro, certifique-se de ter instalado os pacotes IronPDF e Avalonia em seu projeto. Caso contrário, você pode adicioná-los via NuGet.

Agora, vamos programar:

using Avalonia;
using Avalonia.Controls;
using Avalonia.Interactivity;
using Avalonia.Markup.Xaml;
using IronPdf;

public class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();

        // Attach development tools if in DEBUG mode
        // #if DEBUG
        this.AttachDevTools();
        // #endif

        // Assign event handler for the button click event
        this.FindControl<Button>("GeneratePdfButton").Click += OnGeneratePdfButtonClick;
    }

    private void InitializeComponent()
    {
        // Load the XAML layout into the current window
        AvaloniaXamlLoader.Load(this);
    }

    /// <summary>
    /// Event handler for when the "Generate PDF" button is clicked.
    /// Creates and saves a PDF file from an HTML string.
    /// </summary>
    private void OnGeneratePdfButtonClick(object sender, RoutedEventArgs e)
    {
        var Renderer = new ChromePdfRenderer();

        // Render an HTML string as a PDF document
        var PDF = Renderer.RenderHtmlAsPdf("<html><body><h1>Invoice</h1><p>This is a simple invoice.</p></body></html>");

        // Save the rendered PDF to the file system
        PDF.SaveAs("Invoice.pdf");

        // Display a message box to inform the user that the PDF is generated
        MessageBox.Show(this, "Invoice PDF generated successfully.", "Success");
    }
}

using Avalonia;
using Avalonia.Controls;
using Avalonia.Interactivity;
using Avalonia.Markup.Xaml;
using IronPdf;

public class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();

        // Attach development tools if in DEBUG mode
        // #if DEBUG
        this.AttachDevTools();
        // #endif

        // Assign event handler for the button click event
        this.FindControl<Button>("GeneratePdfButton").Click += OnGeneratePdfButtonClick;
    }

    private void InitializeComponent()
    {
        // Load the XAML layout into the current window
        AvaloniaXamlLoader.Load(this);
    }

    /// <summary>
    /// Event handler for when the "Generate PDF" button is clicked.
    /// Creates and saves a PDF file from an HTML string.
    /// </summary>
    private void OnGeneratePdfButtonClick(object sender, RoutedEventArgs e)
    {
        var Renderer = new ChromePdfRenderer();

        // Render an HTML string as a PDF document
        var PDF = Renderer.RenderHtmlAsPdf("<html><body><h1>Invoice</h1><p>This is a simple invoice.</p></body></html>");

        // Save the rendered PDF to the file system
        PDF.SaveAs("Invoice.pdf");

        // Display a message box to inform the user that the PDF is generated
        MessageBox.Show(this, "Invoice PDF generated successfully.", "Success");
    }
}

Imports Avalonia
Imports Avalonia.Controls
Imports Avalonia.Interactivity
Imports Avalonia.Markup.Xaml
Imports IronPdf

Public Class MainWindow
	Inherits Window

	Public Sub New()
		InitializeComponent()

		' Attach development tools if in DEBUG mode
		' #if DEBUG
		Me.AttachDevTools()
		' #endif

		' Assign event handler for the button click event
		AddHandler FindControl(Of Button)("GeneratePdfButton").Click, AddressOf OnGeneratePdfButtonClick
	End Sub

	Private Sub InitializeComponent()
		' Load the XAML layout into the current window
		AvaloniaXamlLoader.Load(Me)
	End Sub

	''' <summary>
	''' Event handler for when the "Generate PDF" button is clicked.
	''' Creates and saves a PDF file from an HTML string.
	''' </summary>
	Private Sub OnGeneratePdfButtonClick(ByVal sender As Object, ByVal e As RoutedEventArgs)
		Dim Renderer = New ChromePdfRenderer()

		' Render an HTML string as a PDF document
		Dim PDF = Renderer.RenderHtmlAsPdf("<html><body><h1>Invoice</h1><p>This is a simple invoice.</p></body></html>")

		' Save the rendered PDF to the file system
		PDF.SaveAs("Invoice.pdf")

		' Display a message box to inform the user that the PDF is generated
		MessageBox.Show(Me, "Invoice PDF generated successfully.", "Success")
	End Sub
End Class

Este código define uma classe MainWindow para a janela principal da nossa aplicação. O construtor MainWindow inicializa a janela e configura um manipulador de eventos para o evento Click do botão. O método OnGeneratePdfButtonClick lida com o evento de clique usando a classe ChromePdfRenderer do IronPDF para renderizar o HTML como um documento PDF e salvá-lo.