Avalonia C# (Geliştiriciler için Nasıl Çalışır)

Geliştirme Ortamınızı Kurma

Avalonia ile geliştirmeye başlamak için geliştirme ortamınızı kurmanız gerekiyor. IDE olarak Visual Studio veya JetBrains Rider kullanabilirsiniz. Öncelikle, Visual Studio veya JetBrains Rider'i kurun. Ardından, IDE'nize Avalonia Visual Studio Eklentisi'ni ekleyin. Bu eklenti, proje şablonları ve bir XAML önizleyici sağlar. Geliştirme deneyiminizi artırır.

Çoklu platform WPF projelerinden geçiş yapanlar için, Avalonia C#, .NET Vakfı tarafından desteklenen harici bağlantılara ve kaynaklara erişimle birlikte tanıdık bir geliştirme süreci sunar.

İlk Avalonia Uygulamanız

İlk Avalonia uygulamanızı oluşturmak basittir. IDE'nizi açın ve Avalonia proje şablonunu seçin. Bu, varsayılan Avalonia kurulumuyla yeni bir proje oluşturur. Proje, ana bir pencere ve temel bir yapılandırmayı içerir. Projenizi çalıştırın ve ilk Avalonia uygulamanızı gözlemleyin. Artık Avalonia C# ile yolculuğunuza başladınız.

Avalonia UI ve XAML'i Anlamak

Avalonia UI, kullanıcı arayüzü tasarımı için XAML'i kullanır. XAML, UI öğelerini tanımlayan bir işaretleme dilidir. Bir Avalonia uygulamasında XAML'e basit bir örnek:

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

Bu kod, ortada bir metin bloğuna sahip bir pencere oluşturur. Metin bloğu 'Merhaba, Avalonia!' gösterir. XAML, UI'nizi tasarlamayı ve ayarlamayı kolaylaştırır.

Stil ve Kontrol Şablonları

Avalonia, esnek bir stil sistemi sunarak ve çok sayıda tasarım ihtiyaçını destekleyerek öne çıkar. Bu sistem, uygulamanızın görünüm ve hissini tanımlamanıza olanak tanır. Tutarlı bir tasarım için kontrol şablonlarını özelleştirebilirsiniz. Bir düğme için basit bir stil nasıl tanımlanır:

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

Bu stil, penceredeki tüm düğmelerin arka planını ve metin rengini değiştirir. Avalonia'nın stil sistemi, temalar ve animasyonlar dahil olmak üzere karmaşık senaryoları destekler.

Veri ve Kontrollerle Çalışmak

Avalonia'da veri bağlama, kullanıcı arayüzünüzün veri kaynaklarınıza bağlanmasını sağlar. Veri bağlamaya basit bir örnek:

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

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

Bu kod, TextBox'ın Text özelliğini veri bağlamınızdaki bir UserName özelliğine bağlar. Avalonia, ListBox, DataGrid ve TreeView gibi farklı amaçlar için geniş bir kontrol yelpazesini destekler.

IronPDF'ye Giriş

IronPDF Kütüphanesi Genel Bakış, PDF'lerle çalışmayı çok kolaylaştıran bir .NET kütüphanesidir. Geliştiricilerin PDF içeriğini programatik olarak oluşturmasına, düzenlemesine ve çıkartmasına olanak tanır. HTML'yi IronPDF ile PDF'ye Dönüştürme yeteneği, özellikle raporlar, faturalar veya bir web sayfası olarak render edilebilen herhangi bir belge için son derece yararlıdır.

Use Case: Merging IronPDF with Avalonia C

Avalonia ile masaüstü uygulaması oluşturduğunuzu, bu uygulamanın PDF olarak fatura oluşturması gerektiğini hayal edin. Uygulamanızın HTML'de güzel bir şekilde tasarlanmış fatura şablonu var ve detayları dinamik olarak doldurup, bir PDF olarak kaydetmek istiyorsunuz. İşte burada IronPDF devreye girer. IronPDF'yi entegre ederek, HTML fatura şablonunuzu verilerle doldurulmuş şekilde işleyebilir ve doğrudan Avalonia uygulamanızdan kaydedebilirsiniz.

Kod Örneği: PDF Faturası Oluşturma

Aşağıda bu işlevselliği nasıl uygulayabileceğinizi gösteren kapsamlı bir örnek bulunmaktadır. Basit bir Avalonia penceresi ve bir buton oluşturacağız. Butona tıklandığında, HTML yazı dizisinden (fatura şablonumuz olarak hizmet verecek) bir PDF oluşturur ve bilgisayarınıza kaydeder.

Öncelikle, projenize IronPDF ve Avalonia paketlerini yüklediğinizden emin olun. Değilse, bunları NuGet üzerinden ekleyebilirsiniz.

Şimdi kodlayalım:

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

Bu kod, uygulamamızın ana penceresi için bir MainWindow sınıfı tanımlar. MainWindow yapıcı metodu, pencereyi başlatır ve butonun Click olayı için bir olay işleyici ayarlar. OnGeneratePdfButtonClick metodu, butona tıklama olayını IronPDF'nin ChromePdfRenderer sınıfını kullanarak HTML'yi PDF belgesi olarak işlemek ve kaydetmek suretiyle ele alır.