PrintPageEventArgs Sınıf

Tanım

Ad Alanı:

System.Drawing.Printing

Bütünleştirilmiş Kod:

System.Drawing.Common.dll

Kaynak:

PrintPageEventArgs.cs

PrintPage olayı için veriler sağlar.

public ref class PrintPageEventArgs : EventArgs

public class PrintPageEventArgs : EventArgs

type PrintPageEventArgs = class
    inherit EventArgs

Public Class PrintPageEventArgs
Inherits EventArgs

Devralma

Object

EventArgs

PrintPageEventArgs

Örnekler

Aşağıdaki kod örneği, üzerinde Formbir Button adlandırılmış printButton ve bir PrintDocument adlandırılmış pd öğesinin oluşturulduğunu varsayar. için Button olayının Click yöntemiyle ilişkilendirildiğinden printButton_Click ve PrintPage olayının PrintDocument örnekteki yöntemle ilişkilendirildiğinden pd_PrintPage emin olun. printButton_Click Örnekteki yöntemi olayı yükselten PrintPage yöntemini çağırır Print ve yönteminde pd_PrintPage belirtilen .bmp dosyasını yazdırır. Bu örneği çalıştırmak için, yolu yazdırmak istediğiniz bit eşlem olarak değiştirin.

System.DrawingBu örnek için , System.Drawing.Printingve System.Windows.Forms ad alanlarını kullanın.

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

Açıklamalar

Uyarı

.NET 6 ve sonraki sürümlerde, bu türü içeren System.Drawing.Common paketi yalnızca Windows işletim sistemlerinde desteklenir. Platformlar arası uygulamalarda bu türün kullanılması derleme zamanı uyarılarına ve çalışma zamanı özel durumlarına neden olur. Daha fazla bilgi için bkz . System.Drawing.Common yalnızca Windows'ta desteklenir.

özelliği, MarginBounds sayfanın kenar boşlukları arasındaki bölümünü temsil eden dikdörtgen alanı alır. özelliği, PageBounds sayfanın toplam alanını temsil eden dikdörtgen alanı alır. özelliği, Graphics boyama işleminin gerçekleştirildiği grafik nesnesini tanımlar. özelliği geçerli PageSettings sayfanın yazıcı ayarlarını alır. Kalan özellikler, yazdırma işinin iptal edilip edilmeyeceğini veya yazdırma işinin daha fazla sayfası olup olmadığını gösterir.

Windows Forms ile yazdırma hakkında daha fazla bilgi için ad alanına genel bakış bölümüne System.Drawing.Printing bakın. Bir Windows Presentation Foundation uygulamasından yazdırmak istiyorsanız ad alanına System.Printing bakın.

Oluşturucular

Name	Description
PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings)	PrintPageEventArgs sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
Cancel	Yazdırma işinin iptal edilip edilmeyeceğini belirten bir değer alır veya ayarlar.
Graphics	Sayfayı Graphics boyamak için kullanılanı alır.
HasMorePages	Ek bir sayfanın yazdırılıp yazdırılmayacağını belirten bir değer alır veya ayarlar.
MarginBounds	Sayfanın kenar boşluklarının içindeki bölümünü temsil eden dikdörtgen alanı alır.
PageBounds	Sayfanın toplam alanını temsil eden dikdörtgen alanı alır.
PageSettings	Geçerli sayfanın sayfa ayarlarını alır.

Ayrıca bkz.

• Graphics
• Rectangle
• PrintEventArgs