Avalonia C# (jak to działa dla programistów)

Konfiguracja środowiska programistycznego

Aby rozpocząć rozwój z Avalonia, należy skonfigurować swoje środowisko programistyczne. Można użyć Visual Studio lub JetBrains Rider jako IDE. Najpierw zainstaluj Visual Studio lub JetBrains Rider. Następnie dodaj Avalonia Visual Studio Extension do swojego IDE. To rozszerzenie zapewnia szablony projektów oraz podgląd XAML. To poprawia doświadczenie programistyczne.

Dla tych, którzy przechodzą z wieloplatformowych projektów WPF, Avalonia C# oferuje znajomy proces rozwoju, z pełnym dostępem do zewnętrznych linków i zasobów wspieranych przez .NET Foundation.

Twoja pierwsza aplikacja Avalonia

Tworzenie pierwszej aplikacji Avalonia jest łatwe. Otwórz swoje IDE i wybierz szablon projektu Avalonia. To tworzy nowy projekt z domyślną konfiguracją Avalonia. Projekt zawiera główne okno i podstawową konfigurację. Uruchom projekt, aby zobaczyć swoją pierwszą aplikację Avalonia w akcji. Teraz rozpocząłeś swoją podróż z Avalonia C#.

Zrozumienie Avalonia UI i XAML

Avalonia UI wykorzystuje XAML do projektowania interfejsu użytkownika. XAML to język znaczników, który definiuje elementy UI. Oto prosty przykład użycia XAML w aplikacji 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>

Ten kod tworzy okno z blokiem tekstu na środku. Blok tekstowy wyświetla "Hello, Avalonia!". Dzięki XAML łatwo jest projektować i dostosowywać swój UI.

Szablony stylizacji i kontrolki

Avalonia wyróżnia się, oferując elastyczny system stylizacji i wsparcie dla licznych potrzeb projektowych. Ten system pozwala zdefiniować wygląd i styl swojej aplikacji. Można dostosować szablony kontrolek dla spójnego projektu. Oto jak można zdefiniować prosty styl dla przycisku:

<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>

Ten styl zmienia tło i kolor tekstu wszystkich przycisków w oknie. System stylizacji Avalonia obsługuje skomplikowane scenariusze, w tym tematy i animacje.

Praca z danymi i kontrolkami

Powiązanie danych w Avalonia umożliwia połączenie UI z źródłami danych. Oto podstawowy przykład powiązania danych:

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

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

Ten kod wiąże właściwość Text kontrolki TextBox z właściwością UserName w kontekście danych. Avalonia obsługuje wiele różnych kontrolek do różnych celów, takich jak ListBox, DataGrid i TreeView.

Wprowadzenie do IronPDF

IronPDF Library Overview to biblioteka .NET, która ułatwia pracę z plikami PDF. Pozwala programistom tworzyć, edytować i wyodrębniać zawartość PDF programistycznie. Jedną z wyróżniających się funkcji IronPDF jest możliwość konwersji HTML do PDF z IronPDF, co czyni ją niezmiernie użyteczną do generowania raportów, faktur lub jakichkolwiek dokumentów, które mogą być wyświetlane jako strona internetowa.

Przypadek użycia: Integracja IronPDF z Avalonia C

Wyobraź sobie, że budujesz aplikację desktopową z Avalonia, która potrzebuje generować faktury jako pliki PDF. Twoja aplikacja ma pięknie zaprojektowany szablon faktury w HTML i chcesz dynamicznie wypełnić szczegóły oraz zapisać ją jako PDF. W tym miejscu do gry wkracza IronPDF. Integrując IronPDF, możesz renderować swój szablon faktury HTML z wypełnionymi danymi i zapisać go bezpośrednio z aplikacji Avalonia.

Przykład kodu: Generowanie faktury PDF

Poniżej znajduje się pełny przykład pokazujący, jak można zaimplementować tę funkcjonalność. Stworzymy prosty window Avalonia z przyciskiem. Po kliknięciu przycisk generuje PDF z łańcucha HTML (który będzie naszym szablonem faktury) i zapisuje go na twoim komputerze.

Najpierw upewnij się, że masz zainstalowane pakiety IronPDF i Avalonia w swoim projekcie. Jeśli nie, możesz je dodać przez NuGet.

Teraz, zajmijmy się kodowaniem:

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

Ten kod definiuje klasę MainWindow dla głównego okna aplikacji. Konstruktor MainWindow inicjuje okno i ustawia obsługę zdarzeń dla zdarzenia Click przycisku. Metoda OnGeneratePdfButtonClick obsługuje zdarzenie kliknięcia, używając klasy ChromePdfRenderer z IronPDF do renderowania HTML jako dokument PDF i zapisywania go.