PrintDialog bileşenine genel bakış

Windows Forms'da yazdırma, öncelikle kullanıcının yazdırmasını sağlamak için bileşenin kullanılmasından PrintDocument oluşur. PrintPreviewDialog Denetimi, PrintDialog ve PageSetupDialog bileşenleri, Windows işletim sistemi kullanıcılarına tanıdık bir grafik arabirimi sağlar.

Bileşen PrintDialog , bir yazıcı seçmek, yazdırılacak sayfaları seçmek ve Windows tabanlı uygulamalarda yazdırmayla ilgili diğer ayarları belirlemek için kullanılan önceden yapılandırılmış bir iletişim kutusudur. Kendi iletişim kutunuzu yapılandırmak yerine yazıcı ve yazdırmayla ilgili ayarlar için basit bir çözüm. Kullanıcıların belgelerinin birçok bölümünü yazdırmasını sağlayabilirsiniz: tümünü yazdırın, seçili sayfa aralığını yazdırın veya seçimi yazdırın. Standart Windows iletişim kutularına güvenerek, temel işlevleri kullanıcılara hemen tanıdık gelen uygulamalar oluşturursunuz. PrintDialog bileşeni CommonDialog sınıfından devralır.

Genellikle, yeni bir PrintDocument bileşen örneği oluşturur ve PrinterSettings ile PageSettings sınıflarını kullanarak nelerin yazdırılacağını açıklayan özellikleri ayarlarsınız. yöntemine yapılan Print çağrı aslında belgeyi yazdırır.

Bileşenle çalışmak

Çalışma zamanında iletişim kutusunu görüntülemek için PrintDialog.ShowDialog yöntemini kullanın. Bu bileşen, tek bir yazdırma işi (PrintDocument sınıfı) veya tek bir yazıcının (PrinterSettings sınıfı) ayarlarıyla ilgili özelliklere sahiptir. Bu iki yazıcıdan biri birden çok yazıcı tarafından paylaşılabilir.

Göster iletişim kutusu yöntemi, forma yazdırma iletişim kutusu eklemenize yardımcı olur. Bileşen, PrintDialog Visual Studio'daki Windows Forms Tasarımcısı'nın altındaki tepside görünür.

Çalışma zamanı esnasında PrintDialog'dan kullanıcıdan gelen veriyi yakalama

Tasarım zamanında yazdırmayla ilgili seçenekleri ayarlayabilirsiniz. Bazen, büyük olasılıkla kullanıcı tarafından yapılan seçimler nedeniyle bu seçenekleri çalışma zamanında değiştirmek isteyebilirsiniz. PrintDialog ve PrintDocument bileşenlerini kullanarak belgeyi yazdırmak için kullanıcı girişi yakalayabilirsiniz. Aşağıdaki adımlarda belge için yazdırma iletişim kutusunun görüntülenmesi gösterilmektedir:

1. Formunuza bir PrintDialog ve PrintDocument bileşeni ekleyin.

2. Form’a eklenen Document’yi PrintDialog’in PrintDocument özelliği olarak ayarlayın.

   PrintDialog1.Document = PrintDocument1
   

   printDialog1.Document = printDocument1;
   

3. PrintDialog yöntemini kullanarak ShowDialog bileşenini görüntüleyin.

   If PrintDialog1.ShowDialog() = DialogResult.OK Then
       PrintDocument1.Print()
   End If
   

   // display show dialog and if user selects "Ok" document is printed
   if (printDialog1.ShowDialog() == DialogResult.OK)
       printDocument1.Print();
   

4. Kullanıcının iletişim kutusundan yazdırma seçenekleri bileşenin PrinterSettings özelliğine PrintDocument kopyalanır.

Yazdırma işleri nasıl oluşturulur?

Windows Forms'da yazdırmanın temeli PrintDocument bileşenidir—daha belirgin olarak PrintPage olayı. PrintPage olayını işlemek için kod yazarak, neyin yazdırılacağını ve nasıl yazdırılacağını belirtebilirsiniz. Aşağıdaki adımlarda yazdırma işi oluşturma işlemi gösterilmektedir:

1. Formunuza bir PrintDocument bileşeni ekleyin.

2. PrintPage olayını işlemek için kod yazın.

   Kendi yazdırma mantığınızı kodlayıp yazdırılacak malzemeyi belirtmeniz gerekir.

   Yazdırılacak malzeme olarak, aşağıdaki kod örneğinde, olay işleyicisinde kırmızı dikdörtgen şeklinde bir örnek grafik oluşturulur PrintPage .

   Private Sub PrintDocument1_PrintPage(ByVal sender As Object, ByVal e As System.Drawing.Printing.PrintPageEventArgs) Handles PrintDocument1.PrintPage
       e.Graphics.FillRectangle(Brushes.Red, New Rectangle(100, 100, 100, 100))
   End Sub
   

   private void PrintDocument1_PrintPage(object sender, System.Drawing.Printing.PrintPageEventArgs e) =>
       e.Graphics.FillRectangle(Brushes.Red, new Rectangle(100, 100, 100, 100));
   

BeginPrint ve EndPrint olayları için de kod yazmak isteyebilirsiniz. Her sayfa yazdırılırken azalan, yazdırılacak toplam sayfa sayısını temsil eden bir tamsayı eklenmesine yardımcı olur.

Uyarı

Kullanıcılarınıza temiz ve verimli bir kullanıcı arabirimi (UI) sağlamak için formunuza bir PrintDialog bileşen ekleyebilirsiniz. Bileşenin DocumentPrintDialog özelliğini ayarlamak, formunuz üzerinde çalıştığınız yazdırma belgesiyle ilgili özellikleri ayarlamanıza olanak tanır.

Program aracılığıyla yazdırma işi oluşturma da dahil olmak üzere Windows Forms yazdırma işlerinin özellikleri hakkında daha fazla bilgi için bkz PrintPageEventArgs. .

Yazdırma işlerini tamamlama

Sık sık, sözcük işlemcileri ve yazdırmayı içeren diğer uygulamalar, kullanıcılara bir yazdırma işinin tamamlandığını belirten bir ileti görüntüleme seçeneği sağlar. EndPrint bileşeninin PrintDocument olayını işleyerek Windows Forms'unuzda bu işlevi sağlayabilirsiniz.

Aşağıdaki yordam, üzerinde bir bileşen bulunan Windows tabanlı bir PrintDocument uygulama oluşturmuş olmanızı gerektirir. Bu yordam, Windows tabanlı bir uygulamadan yazdırmayı etkinleştirmenin standart yoludur. Windows Forms uygulamalarından yazdırma hakkında daha fazla bilgi almak için PrintDocument bileşenini kullanarak nasıl yazdırma işleri oluşturulacağını görün.

1. DocumentName bileşeninin PrintDocument özelliğini ayarlayın.

   PrintDocument1.DocumentName = "SamplePrintApp"
   

   printDocument1.DocumentName = "SamplePrintApp";
   

2. EndPrint olayını işlemek için kod yazın.

   Aşağıdaki kod örneğinde, belgenin yazdırma işleminin tamamlandığını belirten bir ileti kutusu görüntülenir.

   Private Sub PrintDocument1_EndPrint(ByVal sender As Object, ByVal e As System.Drawing.Printing.PrintEventArgs) Handles PrintDocument1.EndPrint
       MessageBox.Show(PrintDocument1.DocumentName + " has finished printing.")
   End Sub
   

   private void PrintDocument1_EndPrint(object sender, System.Drawing.Printing.PrintEventArgs e) =>
       MessageBox.Show(printDocument1.DocumentName + " has finished printing.");