PrintTaskOptions Kelas

Referensi

Definisi

Ruang nama:: Windows.Graphics.Printing

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.

Edit

Mewakili kumpulan metode dan properti untuk mengelola opsi yang menentukan bagaimana konten akan dicetak.

public ref class PrintTaskOptions sealed : IPrintTaskOptionsCore, IPrintTaskOptionsCoreProperties, IPrintTaskOptionsCoreUIConfiguration

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class PrintTaskOptions final : IPrintTaskOptionsCore, IPrintTaskOptionsCoreProperties, IPrintTaskOptionsCoreUIConfiguration

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class PrintTaskOptions : IPrintTaskOptionsCore, IPrintTaskOptionsCoreProperties, IPrintTaskOptionsCoreUIConfiguration

Public NotInheritable Class PrintTaskOptions
Implements IPrintTaskOptionsCore, IPrintTaskOptionsCoreProperties, IPrintTaskOptionsCoreUIConfiguration

Warisan: Object Platform::Object IInspectable PrintTaskOptions

Atribut: ContractVersionAttribute MarshalingBehaviorAttribute

Penerapan: IPrintTaskOptionsCore IPrintTaskOptionsCoreProperties IPrintTaskOptionsCoreUIConfiguration

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

Kelas PrintTaskOptions menyediakan akses ke nilai berbeda yang menentukan bagaimana konten dalam tugas cetak akan diformat selama pencetakan. Objek PrintTaskOptions mungkin berisi informasi seperti ukuran halaman yang dicetak, orientasinya, dan jenis media tempat konten akan dicetak. Selain itu objek PrintTaskOptions menyediakan akses ke daftar opsi yang akan ditampilkan di jendela cetak.

Meskipun setiap opsi di PrintTaskOptions, misalnya MediaSize atau MediaType, memiliki sekumpulan nilai tertentu yang didukung, semua opsi mendukung pola umum yang sama untuk mewakili beberapa kasus umum. Nilai kasus umum adalah Default, Tidak Tersedia , dan PrinterCustom.

Setiap opsi berisi nilai default, dan itu adalah nilai yang ditetapkan ke opsi oleh target cetak. Ketika nilai ini diambil melalui akses properti, itu adalah indikasi bahwa target cetak belum menentukan nilai aktual untuk opsi ini. Saat Anda mengatur nilai default untuk opsi tertentu, itu menunjukkan ke target cetak bahwa nilai tersebut harus menggunakan nilai default yang dimilikinya untuk opsi tersebut. Jika tidak ada nilai default untuk opsi tersebut, maka nilai opsi tidak berubah.

Opsi juga dapat melaporkan nilai NotAvailable . Ini menunjukkan bahwa opsi tertentu tidak tersedia untuk target cetak yang saat ini dipilih. Misalnya, jika properti Duplex mengembalikan nilai NotAvailable , itu menunjukkan bahwa target cetak tidak mendukung fungsionalitas dupleks. Tidak dimungkinkan untuk mengatur opsi ke nilai Tidak Tersedia .

Nilai akhir yang umum untuk semua opsi adalah PrinterCustom. Ini menunjukkan bahwa target cetak mendukung fungsionalitas tetapi pilihan saat ini adalah kustom untuk printer ini. Misalnya, target cetak dapat mendukung metode khusus untuk mengikat dokumen yang bukan salah satu nilai standar. Dalam hal ini kueri properti pada opsi Pengikatan akan mengembalikan nilai PrinterCustom . Ukuran output kustom juga akan direpresentasikan sebagai nilai PrinterCustom tetapi ukuran fisik aktual masih akan tersedia melalui metode GetPageDescription .

Aplikasi juga dapat menggunakan PrintTaskOptions untuk menyesuaikan opsi yang muncul di jendela cetak. Properti DisplayedOptions mengembalikan vektor yang berisi daftar item opsi yang akan ditampilkan. Modifikasi pada daftar ini dengan menyisipkan, menambahkan, menghapus, atau mengurutkan ulang opsi akan tercermin di jendela cetak. Jika target cetak tertentu tidak mendukung opsi, opsi tidak akan ditampilkan kepada pengguna. Untuk nama opsi standar, lihat StandardPrintTaskOptions.

Berikut adalah cuplikan kode yang dapat Anda gunakan, misalnya, untuk mengatur output cetak ke warna, dan juga untuk mengatur ukuran media tempatnya dapat dicetak. Objek PrintTaskOptions diakses melalui properti PrintTask.Options .

// Set output to color
printTask.Options.ColorMode = PrintColorMode.Color;

// Set the media size for printing
printTask.Options.MediaSize = PrintMediaSize.NorthAmericaLegal;

Untuk informasi selengkapnya tentang nilai yang diizinkan untuk opsi tugas cetak ini lihat PrintColorMode dan PrintMediaSize.

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1607	14393	Berbatasan dengan
1607	14393	GetPagePrintTicket
1803	17134	CustomPageRanges
1803	17134	PageRangeOptions

Properti

Binding	Mendapatkan atau mengatur opsi pengikatan untuk tugas cetak.
Bordering	Mendapatkan atau mengatur opsi pembatas untuk tugas cetak.
Collation	Mendapatkan atau mengatur opsi kolase tugas cetak.
ColorMode	Mendapatkan atau mengatur opsi mode warna tugas cetak.
CustomPageRanges	Mendapatkan opsi rentang halaman kustom untuk tugas cetak.
DisplayedOptions	Mendapatkan daftar opsi yang ditampilkan untuk pengalaman cetak.
Duplex	Mendapatkan atau mengatur opsi dupleks tugas cetak.
HolePunch	Mendapatkan atau mengatur opsi pukulan lubang dari tugas cetak.
MaxCopies	Mendapatkan jumlah maksimum salinan yang didukung untuk tugas cetak.
MediaSize	Mendapatkan atau mengatur opsi ukuran media dari tugas cetak.
MediaType	Mendapatkan atau mengatur opsi jenis media untuk tugas cetak.
MinCopies	Mendapatkan jumlah minimum salinan yang diizinkan untuk tugas cetak.
NumberOfCopies	Mendapatkan atau mengatur nilai untuk jumlah salinan untuk tugas cetak.
Orientation	Mendapatkan atau mengatur opsi orientasi untuk tugas cetak.
PageRangeOptions	Mendapatkan opsi rentang halaman untuk tugas cetak.
PrintQuality	Mendapatkan atau mengatur opsi kualitas cetak untuk tugas cetak.
Staple	Mendapatkan atau mengatur opsi staple untuk tugas cetak.

Metode

GetPageDescription(UInt32)	Mengambil dimensi fisik halaman yang dicetak.
GetPagePrintTicket(PrintPageInfo)	Mengambil dimensi fisik dan memformat data halaman yang dicetak.

Berlaku untuk

Bagikan melalui