PrintPageEventArgs Třída

Definice

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
PrintPageEventArgs

Příklady

Následující příklad kódu předpokládá, že Button se na objektu vytvořily pojmenované printButton a PrintDocument pojmenované pdForm. Ujistěte se, Click že je událost pro Button přidružená k printButton_Click metodě a PrintPage že je událost PrintDocument přidružená k pd_PrintPage metodě v příkladu. Metoda printButton_Click z příkladu volá metodu Print vyvolání PrintPage události a vytiskne .bmp soubor zadaný v pd_PrintPage metodě . Chcete-li spustit tento příklad, 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 .

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 rozhraní .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í na kompilaci a výjimky za běhu. Další informace najdete v tématu System.Drawing.Common podporované 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 plochu stránky. Vlastnost Graphics definuje grafický objekt, se kterým se má malovat. Vlastnost PageSettings načte nastavení tiskárny pro aktuální stránku. Zbývající vlastnosti určují, jestli má být tisková úloha zrušena nebo zda má tisková úloha více stránek.

Další informace o tisku s model Windows Forms najdete v přehledu System.Drawing.Printing oboru názvů. Pokud chcete tisknout z Windows Presentation Foundation aplikace, podívejte se na System.Printing obor názvů.

Konstruktory

PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings)

Inicializuje novou instanci PrintPageEventArgs třídy .

Vlastnosti

Cancel

Získá nebo nastaví hodnotu označující, zda má být tisková úloha zrušena.

Graphics

Graphics Získá objekt použitý k vykreslení stránky.

HasMorePages

Získá nebo nastaví hodnotu označ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.

Metody

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetType()

Type Získá z aktuální instance.

(Zděděno od Object)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Platí pro

Viz také