PrintDialog Kelas

Definisi

Ruang nama:

System.Windows.Controls

Rakitan:

PresentationFramework.dll

Memanggil kotak dialog cetak Microsoft Windows standar yang mengonfigurasi PrintTicket dan PrintQueue sesuai dengan input pengguna lalu mencetak dokumen.

public ref class PrintDialog

public class PrintDialog

type PrintDialog = class

Public Class PrintDialog

Warisan

Object

PrintDialog

Contoh

Contoh berikut menunjukkan cara membuat instans dan menampilkan yang sederhana PrintDialog dengan menggunakan markup dan kode Extensible Application Markup Language (XAML).

<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

Keterangan

Pengguna dapat menggunakan kotak dialog Cetak untuk memilih printer, mengonfigurasinya, dan melakukan pekerjaan cetak.

Secara ketat, Anda dapat menggunakan metode tanpa PrintDocument pernah membuka dialog. Dalam pengertian itu, kontrol dapat digunakan sebagai komponen pencetakan yang tidak terlihat. Tetapi karena alasan performa, akan lebih baik menggunakan AddJob metode atau salah satu dari banyak Write metode dan WriteAsync dari XpsDocumentWriter. Untuk informasi selengkapnya tentang ini, lihat Cara: Mencetak File XPS secara Terprogram.

Jangan bingung kelas ini, System.Windows.Controls.PrintDialog, dengan System.Windows.Forms.PrintDialog. Yang terakhir digunakan dengan aplikasi Windows Forms. System.Windows.Controls.PrintDialog digunakan dengan aplikasi Windows Presentation Foundation.

Konstruktor

Nama	Deskripsi
PrintDialog()	Menginisialisasi instans baru dari kelas PrintDialog.

Properti

Nama	Deskripsi
CurrentPageEnabled	Mendapatkan atau menetapkan nilai yang menunjukkan apakah opsi untuk mencetak halaman saat ini diaktifkan.
MaxPage	Mendapatkan atau mengatur nomor halaman tertinggi yang diizinkan dalam rentang halaman.
MinPage	Mendapatkan atau mengatur nomor halaman terendah yang diizinkan dalam rentang halaman.
PageRange	Mendapatkan atau mengatur rentang halaman yang akan dicetak saat PageRangeSelection diatur ke UserPages.
PageRangeSelection	Mendapatkan atau mengatur untuk instans PageRangeSelection ini dari PrintDialog.
PrintableAreaHeight	Mendapatkan tinggi area halaman yang dapat dicetak.
PrintableAreaWidth	Mendapatkan lebar area halaman yang dapat dicetak.
PrintQueue	Mendapatkan atau mengatur PrintQueue yang mewakili pencetak yang dipilih.
PrintTicket	Mendapatkan atau mengatur PrintTicket yang digunakan oleh PrintDialog ketika pengguna mengklik Cetak untuk tugas cetak saat ini.
SelectedPagesEnabled	Mendapatkan atau mengatur nilai yang menunjukkan apakah opsi untuk mencetak halaman yang dipilih diaktifkan.
UserPageRangeEnabled	Mendapatkan atau mengatur nilai yang menunjukkan apakah pengguna kotak dialog Cetak memiliki opsi untuk menentukan rentang halaman yang akan dicetak.

Metode

Nama	Deskripsi
PrintDocument(DocumentPaginator, String)	DocumentPaginator Mencetak objek ke PrintQueue objek yang saat ini dipilih.
PrintVisual(Visual, String)	Mencetak objek visual (non-teks), yang berasal dari Visual kelas, ke PrintQueue yang saat ini dipilih.
ShowDialog()	Memanggil kotak PrintDialog dialog sebagai modal.