PrintQueue.CreateXpsDocumentWriter Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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 |
CreateXpsDocumentWriter(PrintDocumentImageableArea) |
XpsDocumentWriter Membuat objek, membuka dialog cetak umum Windows dan mengembalikan |
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 |
CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange) |
XpsDocumentWriter Membuat objek, membuka dialog cetak umum Windows, menyediakan dialog dengan rentang halaman, dan mengembalikan |
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.