PrintDialog Sınıf

Tanım

Ad Alanı:

System.Windows.Controls

Bütünleştirilmiş Kod:

PresentationFramework.dll

Kullanıcı girişine göre ve yapılandıran ve PrintQueue ardından belgeyi yazdıran standart bir PrintTicket Microsoft Windows yazdırma iletişim kutusunu çağırır.

public ref class PrintDialog

public class PrintDialog

type PrintDialog = class

Public Class PrintDialog

Devralma

Object

PrintDialog

Örnekler

Aşağıdaki örnekte, Genişletilebilir Uygulama Biçimlendirme Dili (XAML) işaretlemesi ve kodu kullanılarak basit PrintDialog bir örneğinin nasıl oluşturulacağı ve görüntüleneceği gösterilmektedir.

<Button Width="200" Click="InvokePrint">Invoke PrintDialog</Button>

...

private void InvokePrint(object sender, RoutedEventArgs e)
    {
        // Create the print dialog object and set options
        PrintDialog pDialog = new PrintDialog();
        pDialog.PageRangeSelection = PageRangeSelection.AllPages;
        pDialog.UserPageRangeEnabled = true;

        // Display the dialog. This returns true if the user presses the Print button.
        Nullable<Boolean> print = pDialog.ShowDialog();
        if (print == true)
        {
            XpsDocument xpsDocument = new XpsDocument("C:\\FixedDocumentSequence.xps", FileAccess.ReadWrite);
            FixedDocumentSequence fixedDocSeq = xpsDocument.GetFixedDocumentSequence();
            pDialog.PrintDocument(fixedDocSeq.DocumentPaginator, "Test print job");
        }
    }

Private Sub InvokePrint(ByVal sender As Object, ByVal e As RoutedEventArgs)
        ' Create the print dialog object and set options
        Dim pDialog As New PrintDialog()
        pDialog.PageRangeSelection = PageRangeSelection.AllPages
        pDialog.UserPageRangeEnabled = True

        ' Display the dialog. This returns true if the user presses the Print button.
        Dim print? As Boolean = pDialog.ShowDialog()
        If print = True Then
            Dim xpsDocument As New XpsDocument("C:\FixedDocumentSequence.xps", FileAccess.ReadWrite)
            Dim fixedDocSeq As FixedDocumentSequence = xpsDocument.GetFixedDocumentSequence()
            pDialog.PrintDocument(fixedDocSeq.DocumentPaginator, "Test print job")
        End If
End Sub

Açıklamalar

Bir kullanıcı yazıcı seçmek, yapılandırmak ve yazdırma işi gerçekleştirmek için Yazdır iletişim kutusunu kullanabilir.

Açıkça belirtmek gerekirse, iletişim kutusunu açmadan yöntemini kullanabilirsiniz PrintDocument . Bu anlamda, denetim görünmeyen bir yazdırma bileşeni olarak kullanılabilir. Ancak performans nedenleriyle yöntemini veya birçok ve WriteAsync yönteminden XpsDocumentWriterWrite birini kullanmak AddJob daha iyi olacaktır. Bu konuda daha fazla bilgi için bkz . Nasıl yapılır: Program Aracılığıyla XPS Dosyalarını Yazdırma.

Bu sınıfı, System.Windows.Controls.PrintDialogile System.Windows.Forms.PrintDialogkarıştırmayın. İkincisi, Windows Forms uygulamalarla kullanılır. System.Windows.Controls.PrintDialogWindows Presentation Foundation uygulamalarla kullanılır.

Oluşturucular

PrintDialog()

PrintDialog sınıfının yeni bir örneğini başlatır.

Özellikler

CurrentPageEnabled	Geçerli sayfayı yazdırma seçeneğinin etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar.
MaxPage	Sayfa aralıklarında izin verilen en yüksek sayfa numarasını alır veya ayarlar.
MinPage	Sayfa aralıklarında izin verilen en düşük sayfa numarasını alır veya ayarlar.
PageRange	olarak ayarlandığında UserPagesyazdırılacak PageRangeSelection sayfa aralığını alır veya ayarlar.
PageRangeSelection	bu örneği PrintDialogiçin öğesini PageRangeSelection alır veya ayarlar.
PrintableAreaHeight	Sayfanın yazdırılabilir alanının yüksekliğini alır.
PrintableAreaWidth	Sayfanın yazdırılabilir alanının genişliğini alır.
PrintQueue	Seçili yazıcıyı temsil eden bir PrintQueue alır veya ayarlar.
PrintTicket	Kullanıcı geçerli yazdırma işi için Yazdır'a PrintTicket tıkladığında tarafından PrintDialog kullanılan değerini alır veya ayarlar.
SelectedPagesEnabled	Seçili sayfaları yazdırma seçeneğinin etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar.
UserPageRangeEnabled	Yazdır iletişim kutusunun kullanıcılarının yazdırılacak sayfa aralıklarını belirtme seçeneğine sahip olup olmadığını gösteren bir değer alır veya ayarlar.

Yöntemler

Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
PrintDocument(DocumentPaginator, String)	DocumentPaginator Seçili durumdaki nesnesine PrintQueue yazdırır.
PrintVisual(Visual, String)	Sınıfından türetilen Visual bir görsel (metin olmayan) nesnesini seçili olan nesneye PrintQueue yazdırır.
ShowDialog()	kalıcı iletişim kutusu olarak öğesini PrintDialog çağırır.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)