PrintPageEventArgs Klasa

Definicja

Przestrzeń nazw:

System.Drawing.Printing

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v8.0.0

Źródło:

PrintPageEventArgs.cs

Udostępnia dane dla zdarzenia PrintPage.

public ref class PrintPageEventArgs : EventArgs

public class PrintPageEventArgs : EventArgs

type PrintPageEventArgs = class
    inherit EventArgs

Public Class PrintPageEventArgs
Inherits EventArgs

Dziedziczenie

Object

EventArgs

PrintPageEventArgs

Przykłady

W poniższym przykładzie kodu przyjęto założenie Button , że nazwana printButton i PrintDocument nazwa pd została utworzona na obiekcie Form. Upewnij się, że Click zdarzenie dla Button obiektu jest skojarzone z printButton_Click metodą , a PrintPage zdarzenie PrintDocument klasy jest skojarzone z pd_PrintPage metodą w przykładzie. Metoda printButton_Click z przykładu wywołuje metodę wywołującą PrintPrintPage zdarzenie i wyświetla plik .bmp określony w metodzie pd_PrintPage . Aby uruchomić ten przykład, zmień ścieżkę na mapę bitową, którą chcesz wydrukować.

W tym przykładzie System.Drawingużyj przestrzeni nazw , System.Drawing.Printingi System.Windows.Forms .

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

Uwagi

Uwaga

W programie .NET 6 i nowszych wersjach pakiet System.Drawing.Common, który obejmuje ten typ, jest obsługiwany tylko w systemach operacyjnych Windows. Użycie tego typu w aplikacjach międzyplatformowych powoduje ostrzeżenia w czasie kompilacji i wyjątki czasu wykonywania. Aby uzyskać więcej informacji, zobacz System.Drawing.Common only supported on Windows (Obsługiwane tylko w systemie Windows).

Właściwość MarginBounds pobiera prostokątny obszar reprezentujący część strony między marginesami. Właściwość PageBounds pobiera prostokątny obszar reprezentujący całkowity obszar strony. Właściwość Graphics definiuje obiekt graficzny, z którym ma być malowany. Właściwość PageSettings pobiera ustawienia drukarki dla bieżącej strony. Pozostałe właściwości wskazują, czy zadanie drukowania powinno zostać anulowane, czy też zadanie drukowania ma więcej stron.

Aby uzyskać więcej informacji na temat drukowania za pomocą Windows Forms, zobacz System.Drawing.Printing omówienie przestrzeni nazw. Jeśli chcesz wydrukować z aplikacji Windows Presentation Foundation, zobacz System.Printing przestrzeń nazw.

Konstruktory

PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings)

Inicjuje nowe wystąpienie klasy PrintPageEventArgs.

Właściwości

Cancel	Pobiera lub ustawia wartość wskazującą, czy zadanie drukowania powinno zostać anulowane.
Graphics	Pobiera element Graphics używany do malowania strony.
HasMorePages	Pobiera lub ustawia wartość wskazującą, czy należy wydrukować dodatkową stronę.
MarginBounds	Pobiera prostokątny obszar reprezentujący część strony wewnątrz marginesów.
PageBounds	Pobiera prostokątny obszar reprezentujący całkowity obszar strony.
PageSettings	Pobiera ustawienia strony dla bieżącej strony.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• Graphics
• Rectangle
• PrintEventArgs