StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) 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.
Memulai urutan kontrol yang menentukan kapan dan cara mencetak halaman dalam dokumen.
public:
override System::Drawing::Graphics ^ OnStartPage(System::Drawing::Printing::PrintDocument ^ document, System::Drawing::Printing::PrintPageEventArgs ^ e);
public override System.Drawing.Graphics OnStartPage (System.Drawing.Printing.PrintDocument document, System.Drawing.Printing.PrintPageEventArgs e);
override this.OnStartPage : System.Drawing.Printing.PrintDocument * System.Drawing.Printing.PrintPageEventArgs -> System.Drawing.Graphics
Public Overrides Function OnStartPage (document As PrintDocument, e As PrintPageEventArgs) As Graphics
Parameter
- document
- PrintDocument
yang PrintDocument mewakili dokumen yang sedang dicetak.
Yang PrintPageEventArgs berisi data tentang cara mencetak halaman dalam dokumen. Awalnya, Graphics properti parameter ini adalah null
. Nilai yang OnStartPage(PrintDocument, PrintPageEventArgs) dikembalikan dari metode akan digunakan untuk mengatur properti ini.
Mengembalikan
Objek Graphics yang mewakili halaman dari PrintDocument.
Pengecualian
Antarmuka Pemrograman Aplikasi (API) Win32 asli tidak dapat menyiapkan driver printer untuk menerima data.
-atau-
Windows API asli tidak dapat memperbarui printer atau konteks perangkat plotter (DC) yang ditentukan menggunakan informasi yang ditentukan.
Keterangan
OnStartPage dipanggil segera sebelum PrintDocument menaikkan PrintPage acara.
OnStartPrint membuat objek yang Graphics digunakan dalam pencetakan. Setelah OnStartPrint dipanggil, OnStartPage metode mengatur objek ke Graphics grafik satu halaman. Metode OnEndPage menghapus Graphics objek, sementara OnEndPrint metode membatalkan alokasi objek.