PrintPageEventArgs Sınıf

Tanım

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
PrintPageEventArgs

Örnekler

Aşağıdaki kod örneği, üzerinde Formbir Button adlandırılmış printButton ve bir PrintDocument adlandırılmış pd 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

Not

.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 boyamanın gerçekleştirildiği grafik nesnesini tanımlar. PageSettings özelliği geçerli sayfanın yazıcı ayarlarını alır. Kalan özellikler, yazdırma işinin iptal edilmesi gerektiğini veya yazdırma işinin daha fazla sayfaya sahip olup olmadığını gösterir.

Windows Forms ile yazdırma hakkında daha fazla bilgi için bkz. ad alanına System.Drawing.Printing genel bakış. bir Windows Presentation Foundation uygulamasından yazdırmak istiyorsanız ad alanına System.Printing bakın.

Oluşturucular

PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings)

PrintPageEventArgs sınıfının yeni bir örneğini başlatır.

Özellikler

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 öğesini 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ı 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.

Yöntemler

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)

Şunlara uygulanır

Ayrıca bkz.