PrintPageEventArgs Kelas

Definisi

Ruang nama:

System.Drawing.Printing

Rakitan:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Sumber:

PrintPageEventArgs.cs

Menyediakan data untuk peristiwa tersebut PrintPage .

public ref class PrintPageEventArgs : EventArgs

public class PrintPageEventArgs : EventArgs

type PrintPageEventArgs = class
    inherit EventArgs

Public Class PrintPageEventArgs
Inherits EventArgs

Warisan

Object

EventArgs

PrintPageEventArgs

Contoh

Contoh kode berikut mengasumsikan Button bernama dan bernama pdPrintDocument telah dibuat pada FormprintButton . Pastikan Click peristiwa untuk Button dikaitkan dengan printButton_Click metode dan PrintPage peristiwa PrintDocument dikaitkan dengan pd_PrintPage metode dalam contoh. Metode printButton_Click dari contoh memanggil Print metode yang menaikkan PrintPage peristiwa, dan mencetak file .bmp yang ditentukan dalam pd_PrintPage metode . Untuk menjalankan contoh ini, ubah jalur ke bitmap yang ingin Anda cetak.

System.DrawingGunakan namespace , System.Drawing.Printing, dan System.Windows.Forms untuk contoh ini.

private:
   // Specifies what happens when the user clicks the Button.
   void printButton_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      try
      {
         pd->Print();
      }
      catch ( Exception^ ex ) 
      {
         MessageBox::Show( "An error occurred while printing", ex->ToString() );
      }
   }

   // Specifies what happens when the PrintPage event is raised.
   void pd_PrintPage( Object^ /*sender*/, PrintPageEventArgs^ ev )
   {
      // Draw a picture.
      ev->Graphics->DrawImage( Image::FromFile( "C:\\My Folder\\MyFile.bmp" ),
         ev->Graphics->VisibleClipBounds );
      
      // Indicate that this is the last page to print.
      ev->HasMorePages = false;
   }

// Specifies what happens when the user clicks the Button.
 private void printButton_Click(object sender, EventArgs e) 
 {
   try 
   {
     // Assumes the default printer.
     pd.Print();
   }  
   catch(Exception ex) 
   {
     MessageBox.Show("An error occurred while printing", ex.ToString());
   }
 }
 
 // Specifies what happens when the PrintPage event is raised.
 private void pd_PrintPage(object sender, PrintPageEventArgs ev) 
 {      
   // Draw a picture.
   ev.Graphics.DrawImage(Image.FromFile("C:\\My Folder\\MyFile.bmp"), ev.Graphics.VisibleClipBounds);
      
   // Indicate that this is the last page to print.
   ev.HasMorePages = false;
 }

' Specifies what happens when the user clicks the Button.
Private Sub printButton_Click(sender As Object, e As EventArgs) _
Handles printButton.Click
    Try
       pd.Print()
    Catch ex As Exception
        MessageBox.Show("An error occurred while printing", _
            ex.ToString())
    End Try
End Sub    

' Specifies what happens when the PrintPage event is raised.
Private Sub pd_PrintPage(sender As Object, ev As PrintPageEventArgs) _
Handles pd.PrintPage

    ' Draw a picture.
    ev.Graphics.DrawImage(Image.FromFile("C:\My Folder\MyFile.bmp"), _
        ev.Graphics.VisibleClipBounds)
    
    ' Indicate that this is the last page to print.
    ev.HasMorePages = False
End Sub

Keterangan

Catatan

Dalam .NET 6 dan versi yang lebih baru, paket System.Drawing.Common, yang mencakup jenis ini, hanya didukung pada sistem operasi Windows. Penggunaan jenis ini dalam aplikasi lintas platform menyebabkan peringatan waktu kompilasi dan pengecualian run-time. Untuk informasi selengkapnya, lihat System.Drawing.Common hanya didukung di Windows.

Properti MarginBounds mengambil area persegi panjang yang mewakili bagian halaman di antara margin. Properti PageBounds mengambil area persegi panjang yang mewakili area total halaman. Properti Graphics mendefinisikan objek grafis untuk melakukan lukisan. Properti PageSettings mengambil pengaturan printer untuk halaman saat ini. Properti yang tersisa menunjukkan apakah tugas cetak harus dibatalkan atau apakah pekerjaan cetak memiliki lebih banyak halaman.

Untuk informasi selengkapnya tentang pencetakan dengan Formulir Windows, lihat System.Drawing.Printing gambaran umum namespace. Jika Anda ingin mencetak dari aplikasi Windows Presentation Foundation, lihat System.Printing namespace.

Konstruktor

PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings)

Menginisialisasi instans baru kelas PrintPageEventArgs.

Properti

Cancel	Mendapatkan atau menetapkan nilai yang menunjukkan apakah pekerjaan cetak harus dibatalkan.
Graphics	Mendapatkan digunakan Graphics untuk melukis halaman.
HasMorePages	Mendapatkan atau menetapkan nilai yang menunjukkan apakah halaman tambahan harus dicetak.
MarginBounds	Mendapatkan area persegi panjang yang mewakili bagian halaman di dalam margin.
PageBounds	Mendapatkan area persegi panjang yang mewakili area total halaman.
PageSettings	Mendapatkan pengaturan halaman untuk halaman saat ini.

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• Graphics
• Rectangle
• PrintEventArgs