PrintDialog Sınıf

Tanım

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

Şunlara uygulanır