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

Geliştirme Ortamınızı Ayarlama

Avalonia ile geliştirme yapmaya başlamak için geliştirme ortamınızı kurmanız gerekir. IDE'niz olarak Visual Studio veya JetBrains Rider kullanabilirsiniz. İlk olarak Visual Studio veya JetBrains Rider'ı kurun. Daha sonra, IDE'nize Avalonia Visual Studio Eklentisi ekleyin. Bu eklenti proje şablonları ve bir XAML önizleyicisi sağlar. Geliştirme deneyiminizi artırır.

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

İlk Avalonia Uygulamanız

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

Avalonia UI ve XAML'ı Anlamak

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

<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, merkezde bir metin bloğu olan bir pencere oluşturur. Metin bloğu "Merhaba, Avalonia!" ifadesini gösterir. XAML, kullanıcı arayüzünüzü tasarlamayı ve ayarlamayı kolaylaştırır.

Stil ve Kontrol Şablonları

Avalonia, esnek bir stil sistemi sağlayarak ve birçok tasarım ihtiyacı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 stilin nasıl tanımlanabileceği şöyledir:

<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 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ışma

Avalonia'da veri bağlama, kullanıcı arayüzünüzü veri kaynaklarınıza bağlamanıza olanak sağlar. İşte veri bağlamanın temel bir örneği:

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

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

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

IronPDF'e Giriş

IronPDF Kütüphane Genel Bakış, PDF'lerle çalışmayı kolaylaştıran bir .NET kütüphanesidir. Geliştiricilerin programlı olarak PDF içeriği oluşturmasına, düzenlemesine ve çıkarmasına olanak tanır. IronPDF'in öne çıkan özelliklerinden biri, HTML'yi IronPDF ile PDF'ye dönüştürme yeteneğidir, bu da raporlar, faturalar veya bir web sayfası olarak render edilebilen herhangi bir belge oluşturmak için inanılmaz derecede kullanışlı hale getirir.

Use Case: Merging IronPDF with Avalonia C

Avalonia ile bir masaüstü uygulaması oluşturduğunuzu ve PDF olarak fatura oluşturmanız gerektiğini hayal edin. Uygulamanızda güzelce tasarlanmış bir fatura şablonunuz var ve bu şablonu dinamik olarak doldurup, PDF olarak kaydetmek istiyorsunuz. İşte burada IronPDF devreye giriyor. IronPDF'i entegre ederek, HTML fatura şablonunuzu doldurulmuş verilerle render edebilir ve doğrudan Avalonia uygulamanızdan kaydedebilirsiniz.

Kod Örneği: PDF Fatura 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 düğme oluşturacağız. Düğmeye tıklanması, HTML dizesinden (fatura şablonumuz olarak hizmet edecek) bir PDF oluşturur ve bunu bilgisayarınıza kaydeder.

İlk olarak, projenizde IronPDF ve Avalonia paketlerini kurduğunuzdan emin olun. Yoksa, 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 düğmenin Click olayına bir olay işleyici kurar. OnGeneratePdfButtonClick metodu, IronPDF'ın ChromePdfRenderer sınıfını kullanarak HTML'yi PDF belgesi olarak render edip kaydeder.