Uygulamalarımız hangi sektöre, hangi amaca hitap ederse etsin genellikle yazdırma işlemlerine ihtiyaç duyulur. Bu ihtiyaç PDF Printer, XPS Printer veya Image Printer gibi sanal yazıcı uygulamalarının kullanımlarındaki artışla daha da fazla ihtiyaç haline geldi. Peki WPF arayüzlerinde yazdırma işlemlerini ve önizleme işlemlerini nasıl yapacağız?

Önemli : Bu yazı için hazırladığım örnek uygulamanın linkini makalenin sonunda bulabilirsiniz. İndirip inceleyebilirsiniz. Uygulamada kodlar arasında yorumlar ekledim, umarım yardımcı olur.

PrintDialog ile WPF'de Yazdırma İşlemleri

WPF'de direkt yazdırma işlemlerini PrintDialog sınıfı ile yaparız. Direkt yazdırma diyorum çünkü bu karşımıza bir önizleme penceresi açmadan direkt yazdırma penceresini çıkartacaktır. Önizleme nasıl yapılır onuda öğreneceğiz birazdan.

1. Visual Studio ile WPF uygulaması açalım. Karşımıza çıkan ana pencerenin (MainWindow) XAML alanına giderek Grid etiketini silip aşağıdaki kodları yapıştıralım.

    <Grid x:Name="anaAlan">
        <Label Content="Soyadınız *" HorizontalAlignment="Left" Margin="16,99,0,0" 
             VerticalAlignment="Top" Width="92"/>
        <TextBlock HorizontalAlignment="Left" Margin="23,21,0,0" TextWrapping="Wrap" 
             Text="Lütfen aşağıdaki başvuru formunu eksiksiz ve doğru bilgilerle doldurun." 
             VerticalAlignment="Top" Width="465" Foreground="#FF232222" TextDecorations="{x:Null}" 
             FontSize="14"/>
        <Label Content="Adınız *" HorizontalAlignment="Left" 
             Margin="16,70,0,0" VerticalAlignment="Top" Width="92"/>
        <Label Content="Cinsiyetiniz *" HorizontalAlignment="Left" 
             Margin="16,127,0,0" VerticalAlignment="Top" Width="92"/>
        <Label Content="e-Posta *" HorizontalAlignment="Left" 
             Margin="16,153,0,0" VerticalAlignment="Top" Width="92"/>
        <Label Content="Telefon&#x9;" HorizontalAlignment="Left" 
             Margin="16,179,0,0" VerticalAlignment="Top" Width="92"/>
        <Label Content="Eklemek İstedikleriniz" HorizontalAlignment="Left" 
             Margin="16,218,0,0" VerticalAlignment="Top" Width="127"/>
        <TextBox HorizontalAlignment="Left" Height="103" 
             Margin="23,249,0,0" TextWrapping="Wrap" VerticalAlignment="Top" Width="471"/>
        <TextBox x:Name="txtAdiniz" HorizontalAlignment="Left" Height="23" Margin="113,70,0,0" 
              TextWrapping="Wrap" VerticalAlignment="Top" Width="150"/>
        <TextBox x:Name="txtSoyadiniz" HorizontalAlignment="Left" Height="23" Margin="113,99,0,0" 
              TextWrapping="Wrap" VerticalAlignment="Top" Width="150"/>
        <ComboBox x:Name="cbxCinsiyet" HorizontalAlignment="Left" 
              Margin="113,127,0,0" VerticalAlignment="Top" Width="150">
            <ComboBoxItem Content="Erkek"/>
            <ComboBoxItem Content="Kadın"/>
        </ComboBox>
        <TextBox x:Name="txtEposta" HorizontalAlignment="Left" Height="23" Margin="113,154,0,0" 
              TextWrapping="Wrap" VerticalAlignment="Top" Width="150"/>
        <TextBox x:Name="txtTelefon" HorizontalAlignment="Left" Height="23" Margin="113,182,0,0" 
              TextWrapping="Wrap" VerticalAlignment="Top" Width="150"/>
        <Button x:Name="btnBasvur" Content="Başvuruyu Gönder" HorizontalAlignment="Left" 
              Margin="381,380,0,0" VerticalAlignment="Top" Width="111"/>
        <Button x:Name="btnYazdir" Content="Yazdır" HorizontalAlignment="Left" 
              Margin="316,380,0,0" VerticalAlignment="Top" Width="60" Click="btnYazdir_Click"/>
        <Button x:Name="btnOnizleme" Content="Önizleme" HorizontalAlignment="Left" 
              Margin="236,380,0,0" VerticalAlignment="Top" Width="75" Click="btnOnizleme_Click"/>
    </Grid>

Grid'in adının anaAlan olduğuna dikkat edin lütfen. Ayrıca butonlarında x:Name özelliklerine gözgezdirmenizde fayda var.

Yukarıdaki kodları yapıştırdıktan sonra aşağıdaki görüntüyü elde etmeniz lazım. Eğer pencere ufak kalıyorsa  Properties penceresinden veya XAML alanından pencerenin Height ve Width özelliklerine biraz yüksek değer verin lütfen.

2- Yazdır butonuna çift tıklıyor ve Click event'ine gidiyoruz. Aşağıdaki kodları yazıyoruz.

        private void btnYazdir_Click(object sender, RoutedEventArgs e)
        {
            PrintDialog formuYazdir = new PrintDialog();

            if (formuYazdir.ShowDialog() == true)
            {
                formuYazdir.PrintVisual((anaAlan), "Form Çıktısı");
            }

            else
            {
                MessageBox.Show("Hiç seçim yapılmadı. Bilginize.");
            }

        }

- formuYazdir adında bir PrintDialog nesnesi yani yazdırma işlemlerini getiren pencereyi oluşturuyoruz.
- if ile formu yazdır penceresinin açılıp seçim yapıp yapılmadığını kontrol ediyoruz.
- anaAlan adını verdiğimiz gridimizi PrintVisual metodunun kollarına atıyoruz bu şu demek anaAlan adlı etiketin içerisindekileri yazdıracağız anlamına gelir. "Form Çıktısı" yazısı ise yazdırılan   dosyanın adıdır. Dilediğinizi yazabilirsiniz. İsterseniz Adınız ve Soyadınız TextBox kontrollerindeki verileri alıp çıktı başlığı olarak kullanabilirsiniz. Hayal gücünüze kalmış.
- else durumunu yazmasanızda olur ama ben yazmak istedim.

Şimdi uygulamamızı çalıştırıp Yazdır butonuna tıkladığınızda aşağıdaki gibi bir pencere açılacaktır.

WPF'de Yazdırma Öncesi Önizleme (PrintPreview) Yapımı

Malesef WPF'de PrintPreview işlemini yerine getirmek için özel olarak hazırlanmış bir nesne yok . Öncelikle bu işlemi kendi oluşturacağınız sınıflar ve metodlar ile yapabilirsiniz. Ayrıca sırf yazdırma ve önizleme için yazılmış kontroller var (Ör: RadDiagramPrintPreview, WPF PrintPreview Engine... gibi) dilerseniz onlarıda kullanabilirsiniz ama uygulamanızda önizleme için ufak bir hileyle kendi önizleme penceremizi oluşturabiliriz. PrintPreview için nesne yok diye üzülmek yok. Yaparız olur.

1- Yazdırma Önizlemesi (PrintPreview) işleminde kullanmak için projemize yeni bir Window ekliyoruz ve adını OnIzleme yapıyoruz ve aşağıdaki minik kodu yeni Window'umuzun XAML alanına yapıştırıyoruz. Gördüğünüz gibi DocumentViewer nesnesi eklemişiz ve adını XpsOkuyu yapmışız.

    <Grid>
        <DocumentViewer  x:Name="XpsOkuyucu" />
    </Grid>

2- OnIzleme penceresindeyken F7'ye basıyoruz ve kod kısmına geçiyoruz aşağıdaki gibi kodlarımızı yazıyoruz. Kodların InitializeComponent(); kod satırından sonra geldiğine dikkat edin. Aksi halde pencere ya açılamayacak ya da açılsa bile her tarafı gri olan bir pencere açılacaktır.

    public partial class OnIzleme : Window
    {
        public OnIzleme()
        {
            InitializeComponent();

            XpsDocument okunacakBelge = new XpsDocument(@"C:\Temp\onizleme.xps", FileAccess.Read);
            XpsOkuyucu.Document = okunacakBelge.GetFixedDocumentSequence();
        }
    }

Buradaki espri şu: MainWindow'da bulunan Önizleme butonuna tıklandığında arkaplanda bir onizleme.xps dosyası oluşturacak, dosya oluştuktan sonra OnIzleme adlı yukarıdaki penceremiz açılacak ve arkaplanda oluşturduğumuz onizleme.xps dosyasını ekranda gösterecek. Kurnazca bir çözüm olsada en pratik çözümdür. Sonuçta önizleme.

Burada dikkat etmeniz gereken, ben Temp klasörü oluşturup adres gösterdim eğer Temp adında klasörünüz yoksa uygulama hata verecektir. Bu durumu tabi if ve System.IO sınıfından Directory işlemlerini kullanarak engelleyebilirdik, öyle bir klasör yoksa oluştur diyebilirdik veya sistem tempory kullan diyebilirdik ama konumuz dışında.

Yine bura için önemli son bir not: Kod karmaşası olmaması için onizleme.xps adında bir belge oluşturmasını istedim burada önemli olan oluşan dosyayı diğer pencere tarafında aynı isimle yakalayıp gösterebilmek. Dosya adı sürekli değişecek bir yapıda olabilir ve buna göre bir önlem almanız gerekebilir. Hatırlatmakta fayda var.

3- Şimdi tekrar MainWindow'umuza dönüyoruz ve Önizleme butonumuza çift tıklayarak Click eventine gidiyoruz ve aşağıdaki C# kodlarını yazıyoruz.

private void btnOnizleme_Click(object sender, RoutedEventArgs e)
        {
            Package onizlemeBilgiler = Package.Open(@"C:\Temp\onizleme.xps", FileMode.Create);

            XpsDocument onizleme = new XpsDocument(onizlemeBilgiler);

            XpsDocumentWriter xpsYazici = XpsDocument.CreateXpsDocumentWriter(onizleme);

            xpsYazici.Write(anaAlan);

            onizleme.Close();
            onizlemeBilgiler.Close();

            OnIzleme ac = new OnIzleme();
            ac.Show();
        }

Yukarıdaki kodları aşağıda satır satır açıklayalım.

//Package sınıfından onizlemeBilgiler adında nesne oluşturuyoruz ve 
//bu nesneye kayıt yerini ve ne yapacağını belirtiyoruz. 
//Package nesnesi zaten bunun içindir.
Package onizlemeBilgiler = Package.Open(@"C:\Temp\onizleme.xps", FileMode.Create);

//onizleme adında Xps nesnesi oluşturuyoruz ve gerekli bilgileri oluşturduğumuz 
//onizlemeBilgiler adlı Package nesnesinden alıyoruz.
XpsDocument onizleme = new XpsDocument(onizlemeBilgiler);

//xpsYazici adında Xps yazıcı nesnesi oluşturuyoruz ve 
//hangi dökümanı baz alacağını (onizleme) belirtiyoruz
XpsDocumentWriter xpsYazici = XpsDocument.CreateXpsDocumentWriter(onizleme);

//anaAlan adlı grid nesnemizi baz almasını ve bu nesne içerisinde olan her şeyi yazdırmasını istiyoruz.
xpsYazici.Write(anaAlan);

//Artık xps oluşturma işimiz bitti ve package nesnemizle dökümanımızı kapatmamız lazım.
            onizleme.Close();
            onizlemeBilgiler.Close();

//Solution Explorer içerisinde bulunan önceden oluşturduğumuz 
//OnIzleme adlı pencereden bir nesne oluşturuyoruz ve Show() metodu ile gösteriyoruz.
            OnIzleme ac = new OnIzleme();
            ac.Show();

Önizleme penceresinin görüntüsü:

İndir : Örnek Uygulamanın Kaynak Kodları