PrintPageEventArgs Třída

Definice

Obor názvů:

System.Drawing.Printing

Sestavení:

System.Drawing.Common.dll

Zdroj:

PrintPageEventArgs.cs

Poskytuje data pro událost PrintPage.

public ref class PrintPageEventArgs : EventArgs

public class PrintPageEventArgs : EventArgs

type PrintPageEventArgs = class
    inherit EventArgs

Public Class PrintPageEventArgs
Inherits EventArgs

Dědičnost

Object

EventArgs

PrintPageEventArgs

Příklady

Následující příklad kódu předpokládá pojmenovaný ButtonprintButton a pojmenovaný pdPrintDocument byl vytvořen na .Form Ujistěte se, že Click je událost pro Button metodu printButton_Click přidružena a PrintPage událost je PrintDocument přidružena k pd_PrintPage metodě v příkladu. Metoda printButton_Click z příkladu volá metodu Print vyvolá PrintPage událost a vytiskne .bmp soubor zadaný v pd_PrintPage metodě. Pokud chcete tento příklad spustit, změňte cestu na rastrový obrázek, který chcete vytisknout.

V tomto příkladu System.Drawingpoužijte obory názvů , System.Drawing.Printinga System.Windows.Forms obory názvů.

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

Poznámky

Poznámka:

V .NET 6 a novějších verzích je balíček System.Drawing.Common, který obsahuje tento typ, podporován pouze v operačních systémech Windows. Použití tohoto typu v multiplatformních aplikacích způsobuje upozornění v době kompilace a výjimky za běhu. Další informace naleznete v tématu System.Drawing.Common podporován pouze ve Windows.

Vlastnost MarginBounds načte obdélníkovou oblast, která představuje část stránky mezi okraji. Vlastnost PageBounds načte obdélníkovou oblast, která představuje celkovou oblast stránky. Vlastnost Graphics definuje grafický objekt, se kterým se má malování provést. Vlastnost PageSettings načte nastavení tiskárny pro aktuální stránku. Zbývající vlastnosti označují, zda má být úloha tisku zrušena nebo zda má tisková úloha více stránek.

Další informace o tisku pomocí Modelu Windows Forms naleznete v přehledu System.Drawing.Printing oboru názvů. Pokud chcete tisknout z aplikace Windows Presentation Foundation, přečtěte si System.Printing obor názvů.

Konstruktory

Name	Description
PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings)	Inicializuje novou instanci PrintPageEventArgs třídy.

Vlastnosti

Name	Description
Cancel	Získá nebo nastaví hodnotu určující, zda má být úloha tisku zrušena.
Graphics	Graphics Získá použité k malování stránky.
HasMorePages	Získá nebo nastaví hodnotu určující, zda má být vytištěna další stránka.
MarginBounds	Získá obdélníkovou oblast, která představuje část stránky uvnitř okrajů.
PageBounds	Získá obdélníkovou oblast, která představuje celkovou oblast stránky.
PageSettings	Získá nastavení stránky pro aktuální stránku.

Viz také

• Graphics
• Rectangle
• PrintEventArgs