Share via


PrintQueue.CreateXpsDocumentWriter Metode

Definisi

Membuat objek XpsDocumentWriter.

Overload

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

XpsDocumentWriter Membuat objek, membuka dialog cetak umum Windows, menyediakan dialog dengan rentang halaman dan deskripsi pekerjaan cetak, dan mengembalikan ref parameter (ByRef dalam Visual Basic) yang mewakili informasi tentang area yang dapat digambarkan dan dimensi media.

CreateXpsDocumentWriter(PrintDocumentImageableArea)

XpsDocumentWriter Membuat objek, membuka dialog cetak umum Windows dan mengembalikan ref parameter (ByRef dalam Visual Basic) yang mewakili informasi tentang area yang dapat digambutkan dan dimensi media.

CreateXpsDocumentWriter(PrintQueue)

XpsDocumentWriter Membuat objek dan mengaitkannya dengan antrean cetak yang ditentukan.

CreateXpsDocumentWriter(Double, Double)

XpsDocumentWriter Membuat objek dengan dimensi yang ditentukan.

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

XpsDocumentWriter Membuat objek, membuka dialog cetak umum Windows (dan menyediakan deskripsi pekerjaan) dan mengembalikan ref parameter (ByRef dalam Visual Basic) yang mewakili informasi tentang area yang dapat digambarkan dan dimensi media.

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

XpsDocumentWriter Membuat objek, membuka dialog cetak umum Windows, menyediakan dialog dengan rentang halaman, dan mengembalikan ref parameter (ByRef dalam Visual Basic) yang mewakili informasi tentang area yang dapat digambutkan dan dimensi media.

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

XpsDocumentWriter Membuat objek, membuka dialog cetak umum Windows, menyediakan dialog dengan rentang halaman dan deskripsi pekerjaan cetak, dan mengembalikan ref parameter (ByRef dalam Visual Basic) yang mewakili informasi tentang area yang dapat digambarkan dan dimensi media.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(System::Printing::PrintDocumentImageableArea ^ % documentImageableArea, System::Windows::Controls::PageRangeSelection % pageRangeSelection, System::Windows::Controls::PageRange % pageRange);
[System.Security.SecurityCritical]
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (ref System.Printing.PrintDocumentImageableArea documentImageableArea, ref System.Windows.Controls.PageRangeSelection pageRangeSelection, ref System.Windows.Controls.PageRange pageRange);
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (ref System.Printing.PrintDocumentImageableArea documentImageableArea, ref System.Windows.Controls.PageRangeSelection pageRangeSelection, ref System.Windows.Controls.PageRange pageRange);
[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : PrintDocumentImageableArea * PageRangeSelection * PageRange -> System.Windows.Xps.XpsDocumentWriter
static member CreateXpsDocumentWriter : PrintDocumentImageableArea * PageRangeSelection * PageRange -> System.Windows.Xps.XpsDocumentWriter
Public Shared Function CreateXpsDocumentWriter (ByRef documentImageableArea As PrintDocumentImageableArea, ByRef pageRangeSelection As PageRangeSelection, ByRef pageRange As PageRange) As XpsDocumentWriter

Parameter

documentImageableArea
PrintDocumentImageableArea

Referensi ke objek yang berisi dimensi area halaman tempat perangkat dapat mencetak. Karena jenis datanya tidak memiliki konstruktor publik, parameter ini diteruskan tanpa diinisialisasi.

pageRangeSelection
PageRangeSelection

Nilai yang menentukan apakah akan mencetak semua halaman atau hanya rentang yang ditentukan oleh pengguna.

pageRange
PageRange

Rentang halaman yang dicetak.

Mengembalikan

Yang XpsDocumentWriter menulis data XPS ke aliran. Ini bisa menjadi null. (Parameter documentImageableArea, pageRangeSelection, dan pageRange semuanya ref [ByRef dalam parameter Visual Basic] yang diinisialisasi oleh pengguna dan dikembalikan saat dialog ditutup, sehingga masing-masing mewakili item tambahan yang dikembalikan.)

Atribut

Keterangan

Banyak printer membutuhkan hingga seperempat inci ruang yang tidak tercetak di sekitar tepi setiap halaman untuk mencengkeram kertas dan memindahkannya melalui printer. Jika tidak, toner akan menggagalkan mekanisme aliran kertas. Area yang dapat dicetak adalah "area yang dapat disortir."

Jenis PrintDocumentImageableArea tidak memiliki konstruktor publik. Oleh karena itu, variabel documentImageableArea harus dideklarasikan dan ditetapkan ke null dan hanya kemudian diteruskan ke metode . Metode ini menampilkan input yang PrintDialog memerlukan dari pengguna. Pengguna mengonfigurasi pekerjaan cetak mereka pada dialog (termasuk memilih printer, ukuran kertas, orientasi, dan rentang halaman). Saat dialog ditutup, pageRangeSelection dan pageRange memiliki nilai, dan documentImageableArea menunjuk ke objek aktual yang propertinya diinisialisasi.

Jika pengguna membatalkan atau menutup dialog, nilai yang dikembalikan adalah null. Akibatnya, nilai pengembalian harus diperiksa null oleh aplikasi Anda.

Lihat juga

Berlaku untuk

CreateXpsDocumentWriter(PrintDocumentImageableArea)

XpsDocumentWriter Membuat objek, membuka dialog cetak umum Windows dan mengembalikan ref parameter (ByRef dalam Visual Basic) yang mewakili informasi tentang area yang dapat digambutkan dan dimensi media.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(System::Printing::PrintDocumentImageableArea ^ % documentImageableArea);
[System.Security.SecurityCritical]
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (ref System.Printing.PrintDocumentImageableArea documentImageableArea);
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (ref System.Printing.PrintDocumentImageableArea documentImageableArea);
[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : PrintDocumentImageableArea -> System.Windows.Xps.XpsDocumentWriter
static member CreateXpsDocumentWriter : PrintDocumentImageableArea -> System.Windows.Xps.XpsDocumentWriter
Public Shared Function CreateXpsDocumentWriter (ByRef documentImageableArea As PrintDocumentImageableArea) As XpsDocumentWriter

Parameter

documentImageableArea
PrintDocumentImageableArea

Referensi ke objek yang berisi dimensi area halaman tempat perangkat dapat mencetak. Karena jenis datanya tidak memiliki konstruktor publik, parameter ini diteruskan tanpa diinisialisasi.

Mengembalikan

Yang XpsDocumentWriter menulis data XPS ke aliran. Ini bisa menjadi null. (Parameter documentImageableArea adalah ref parameter [ByRef dalam Visual Basic] yang diinisialisasi oleh metode , sehingga mewakili item kedua yang dikembalikan.)

Atribut

Keterangan

Banyak printer membutuhkan hingga seperempat inci ruang yang tidak tercetak di sekitar tepi setiap halaman untuk mencengkeram kertas dan memindahkannya melalui printer. Jika tidak, toner akan menggagalkan mekanisme aliran kertas. Area yang dapat dicetak adalah "area yang dapat disortir."

Jenis PrintDocumentImageableArea tidak memiliki konstruktor publik. Oleh karena itu, variabel documentImageableArea harus dideklarasikan dan ditetapkan ke null dan hanya kemudian diteruskan ke metode . Metode ini menampilkan input yang PrintDialog memerlukan dari pengguna. Setelah pengguna memilih printer, ukuran kertas, dan orientasi dan menutup dialog, documentImageableArea arahkan ke objek aktual dan propertinya diinisialisasi.

Jika pengguna membatalkan atau menutup dialog, nilai yang dikembalikan adalah null. Akibatnya, nilai pengembalian harus diperiksa null oleh aplikasi Anda.

Lihat juga

Berlaku untuk

CreateXpsDocumentWriter(PrintQueue)

XpsDocumentWriter Membuat objek dan mengaitkannya dengan antrean cetak yang ditentukan.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(System::Printing::PrintQueue ^ printQueue);
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (System.Printing.PrintQueue printQueue);
static member CreateXpsDocumentWriter : System.Printing.PrintQueue -> System.Windows.Xps.XpsDocumentWriter
Public Shared Function CreateXpsDocumentWriter (printQueue As PrintQueue) As XpsDocumentWriter

Parameter

printQueue
PrintQueue

Antrean cetak untuk mencetak dokumen XPS.

Mengembalikan

Yang XpsDocumentWriter menulis ke aliran XPS.

Contoh

Contoh berikut menunjukkan cara menggunakan metode ini untuk membuat XpsDocumentWriter.

// -------------------- GetPrintXpsDocumentWriter() -------------------
/// <summary>
///   Returns an XpsDocumentWriter for the default print queue.</summary>
/// <returns>
///   An XpsDocumentWriter for the default print queue.</returns>
private XpsDocumentWriter GetPrintXpsDocumentWriter()
{
    // Create a local print server
    LocalPrintServer ps = new LocalPrintServer();

    // Get the default print queue
    PrintQueue pq = ps.DefaultPrintQueue;

    // Get an XpsDocumentWriter for the default print queue
    XpsDocumentWriter xpsdw = PrintQueue.CreateXpsDocumentWriter(pq);
    return xpsdw;
}// end:GetPrintXpsDocumentWriter()
' -------------------- GetPrintXpsDocumentWriter() -------------------
''' <summary>
'''   Returns an XpsDocumentWriter for the default print queue.</summary>
''' <returns>
'''   An XpsDocumentWriter for the default print queue.</returns>
Private Function GetPrintXpsDocumentWriter() As XpsDocumentWriter
    ' Create a local print server
    Dim ps As New LocalPrintServer()

    ' Get the default print queue
    Dim pq As PrintQueue = ps.DefaultPrintQueue

    ' Get an XpsDocumentWriter for the default print queue
    Dim xpsdw As XpsDocumentWriter = PrintQueue.CreateXpsDocumentWriter(pq)
    Return xpsdw
End Function ' end:GetPrintXpsDocumentWriter()

Lihat juga

Berlaku untuk

CreateXpsDocumentWriter(Double, Double)

XpsDocumentWriter Membuat objek dengan dimensi yang ditentukan.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(double % width, double % height);
[System.Security.SecurityCritical]
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (ref double width, ref double height);
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (ref double width, ref double height);
[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : double * double -> System.Windows.Xps.XpsDocumentWriter
static member CreateXpsDocumentWriter : double * double -> System.Windows.Xps.XpsDocumentWriter
Public Shared Function CreateXpsDocumentWriter (ByRef width As Double, ByRef height As Double) As XpsDocumentWriter

Parameter

width
Double

Lebar dokumen XPS.

height
Double

Tinggi dokumen XPS.

Mengembalikan

Yang XpsDocumentWriter menulis ke aliran XPS. Ini bisa menjadi null.

Atribut

Keterangan

Metode ini menampilkan input yang PrintDialog memerlukan dari pengguna. Jika pengguna membatalkan atau menutup dialog, nilai yang dikembalikan adalah null. Akibatnya, nilai pengembalian harus diperiksa null oleh aplikasi Anda.

Lihat juga

Berlaku untuk

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

XpsDocumentWriter Membuat objek, membuka dialog cetak umum Windows (dan menyediakan deskripsi pekerjaan) dan mengembalikan ref parameter (ByRef dalam Visual Basic) yang mewakili informasi tentang area yang dapat digambarkan dan dimensi media.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(System::String ^ jobDescription, System::Printing::PrintDocumentImageableArea ^ % documentImageableArea);
[System.Security.SecurityCritical]
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (string jobDescription, ref System.Printing.PrintDocumentImageableArea documentImageableArea);
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (string jobDescription, ref System.Printing.PrintDocumentImageableArea documentImageableArea);
[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : string * PrintDocumentImageableArea -> System.Windows.Xps.XpsDocumentWriter
static member CreateXpsDocumentWriter : string * PrintDocumentImageableArea -> System.Windows.Xps.XpsDocumentWriter
Public Shared Function CreateXpsDocumentWriter (jobDescription As String, ByRef documentImageableArea As PrintDocumentImageableArea) As XpsDocumentWriter

Parameter

jobDescription
String

Nama untuk tugas cetak. Ini muncul di antarmuka pengguna pencetakan Windows.

documentImageableArea
PrintDocumentImageableArea

Referensi ke objek yang berisi dimensi area halaman tempat perangkat dapat mencetak. Karena jenis datanya tidak memiliki konstruktor publik, parameter ini diteruskan tanpa diinisialisasi.

Mengembalikan

Yang XpsDocumentWriter menulis data XPS ke aliran. Ini bisa menjadi null. (Parameter documentImageableArea adalah ref parameter [ByRef dalam Visual Basic] yang diinisialisasi oleh metode , sehingga mewakili item kedua yang dikembalikan.)

Atribut

Keterangan

Banyak printer membutuhkan hingga seperempat inci ruang yang tidak tercetak di sekitar tepi setiap halaman untuk mencengkeram kertas dan memindahkannya melalui printer. Jika tidak, toner akan menggagalkan mekanisme aliran kertas. Area yang dapat dicetak adalah "area yang dapat disortir."

Jenis PrintDocumentImageableArea tidak memiliki konstruktor publik. Oleh karena itu, variabel documentImageableArea harus dideklarasikan dan ditetapkan ke null dan hanya kemudian diteruskan ke metode . Metode ini menampilkan input yang PrintDialog memerlukan dari pengguna. Setelah pengguna memilih printer, ukuran kertas, dan orientasi dan menutup dialog, documentImageableArea menunjuk ke objek aktual, dan propertinya diinisialisasi.

Jika pengguna membatalkan atau menutup dialog, nilai yang dikembalikan adalah null. Akibatnya, nilai pengembalian harus diperiksa null oleh aplikasi Anda.

Lihat juga

Berlaku untuk

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

XpsDocumentWriter Membuat objek, membuka dialog cetak umum Windows, menyediakan dialog dengan rentang halaman, dan mengembalikan ref parameter (ByRef dalam Visual Basic) yang mewakili informasi tentang area yang dapat digambutkan dan dimensi media.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(System::String ^ jobDescription, System::Printing::PrintDocumentImageableArea ^ % documentImageableArea, System::Windows::Controls::PageRangeSelection % pageRangeSelection, System::Windows::Controls::PageRange % pageRange);
[System.Security.SecurityCritical]
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (string jobDescription, ref System.Printing.PrintDocumentImageableArea documentImageableArea, ref System.Windows.Controls.PageRangeSelection pageRangeSelection, ref System.Windows.Controls.PageRange pageRange);
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (string jobDescription, ref System.Printing.PrintDocumentImageableArea documentImageableArea, ref System.Windows.Controls.PageRangeSelection pageRangeSelection, ref System.Windows.Controls.PageRange pageRange);
[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : string * PrintDocumentImageableArea * PageRangeSelection * PageRange -> System.Windows.Xps.XpsDocumentWriter
static member CreateXpsDocumentWriter : string * PrintDocumentImageableArea * PageRangeSelection * PageRange -> System.Windows.Xps.XpsDocumentWriter
Public Shared Function CreateXpsDocumentWriter (jobDescription As String, ByRef documentImageableArea As PrintDocumentImageableArea, ByRef pageRangeSelection As PageRangeSelection, ByRef pageRange As PageRange) As XpsDocumentWriter

Parameter

jobDescription
String

Nama untuk tugas cetak. Ini muncul di antarmuka pengguna pencetakan Windows.

documentImageableArea
PrintDocumentImageableArea

Referensi ke objek yang berisi dimensi area halaman tempat perangkat dapat mencetak. Karena jenis datanya tidak memiliki konstruktor publik, parameter ini diteruskan tanpa diinisialisasi.

pageRangeSelection
PageRangeSelection

Nilai yang menentukan apakah akan mencetak semua halaman atau hanya rentang yang ditentukan oleh pengguna.

pageRange
PageRange

Rentang halaman yang dicetak.

Mengembalikan

Yang XpsDocumentWriter menulis data XPS ke aliran. Ini bisa berupa null. (Parameter documentImageableArea, pageRangeSelection, dan pageRange semuanya ref [ByRef dalam parameter Visual Basic] yang diinisialisasi oleh pengguna dan dikembalikan saat dialog ditutup, sehingga masing-masing mewakili item tambahan yang dikembalikan.)

Atribut

Keterangan

Banyak printer membutuhkan hingga seperempat inci ruang yang tidak tercetak di sekitar tepi setiap halaman untuk mencengkeram kertas dan memindahkannya melalui printer. Jika tidak, toner akan menggagalkan mekanisme aliran kertas. Area yang dapat dicetak adalah "area yang dapat disortir."

Jenis PrintDocumentImageableArea tidak memiliki konstruktor publik. Oleh karena itu, variabel documentImageableArea harus dideklarasikan dan ditetapkan ke null dan hanya kemudian diteruskan ke metode . Metode ini menampilkan input yang PrintDialog memerlukan dari pengguna. Pengguna mengonfigurasi pekerjaan cetak mereka pada dialog (termasuk memilih printer, ukuran kertas, orientasi, dan rentang halaman). Saat dialog ditutup, pageRangeSelection dan pageRange memiliki nilai, dan documentImageableArea menunjuk ke objek aktual yang propertinya diinisialisasi.

Jika pengguna membatalkan atau menutup dialog, nilai yang dikembalikan adalah null. Akibatnya, nilai pengembalian harus diperiksa null oleh aplikasi Anda.

Lihat juga

Berlaku untuk