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 PrintTicket yapılandıran ve ardından belgeyi yazdıran standart bir PrintQueue 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 bir örneğinin nasıl oluşturulacağı ve basit PrintDialog bir 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.Value)
    {
        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 yönteminden AddJobbirini kullanmak Write daha iyi WriteAsync olacaktır.XpsDocumentWriter 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ı ile System.Windows.Controls.PrintDialogSystem.Windows.Forms.PrintDialogkarıştırmayın. İkincisi, Windows Forms uygulamalarıyla birlikte kullanılır. System.Windows.Controls.PrintDialog , Windows Presentation Foundation uygulamalarıyla birlikte kullanılır.

Oluşturucular

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

Özellikler

Name	Description
CurrentPageEnabled	Geçerli sayfayı yazdırma seçeneğinin etkin olup olmadığını gösteren 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 PageRangeSelectionyazdırılacak UserPages sayfa aralığını alır veya ayarlar.
PageRangeSelection	bu örneği PageRangeSelectioniçin öğesini PrintDialog 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 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 gösteren 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

Name	Description
PrintDocument(DocumentPaginator, String)	Seçili olan nesneye DocumentPaginator bir PrintQueue nesne yazdırır.
PrintVisual(Visual, String)	Sınıfından Visual türetilen bir görsel (metin olmayan) nesnesini seçili olan nesneye PrintQueue yazdırır.
ShowDialog()	PrintDialog kalıcı iletişim kutusu olarak öğesini çağırır.