PrintPageEventArgs Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece dados para o evento de PrintPage .
public ref class PrintPageEventArgs : EventArgs
public class PrintPageEventArgs : EventArgs
type PrintPageEventArgs = class
inherit EventArgs
Public Class PrintPageEventArgs
Inherits EventArgs
- Herança
Exemplos
O exemplo de código a seguir pressupõe que um Button nomeado printButton
e um PrintDocument nomeado pd
foram criados em um Form. Verifique se o Click evento para o Button está associado printButton_Click
ao método e se o PrintPage evento do PrintDocument está associado ao pd_PrintPage
método no exemplo. O printButton_Click
método do exemplo chama o Print método que aciona o PrintPage evento e imprime o arquivo .bmp especificado no pd_PrintPage
método . Para executar este exemplo, altere o caminho para o bitmap que você deseja imprimir.
Use os System.Drawingnamespaces , System.Drawing.Printinge System.Windows.Forms para este exemplo.
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
Comentários
Observação
No .NET 6 e versões posteriores, o pacote System.Drawing.Common, que inclui esse tipo, só tem suporte em sistemas operacionais Windows. O uso desse tipo em aplicativos multiplataforma causa avisos de tempo de compilação e exceções em tempo de execução. Para obter mais informações, consulte System.Drawing.Common com suporte apenas no Windows.
A MarginBounds propriedade recupera a área retangular que representa a parte da página entre as margens. A PageBounds propriedade recupera a área retangular que representa a área total da página. A Graphics propriedade define o objeto gráfico com o qual fazer a pintura. A PageSettings propriedade recupera as configurações da impressora para a página atual. As propriedades restantes indicam se um trabalho de impressão deve ser cancelado ou se um trabalho de impressão tem mais páginas.
Para obter mais informações sobre impressão com Windows Forms, consulte a visão geral do System.Drawing.Printing namespace. Se você quiser imprimir de um aplicativo Windows Presentation Foundation, consulte o System.Printing namespace.
Construtores
PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings) |
Inicializa uma nova instância da classe PrintPageEventArgs. |
Propriedades
Cancel |
Obtém ou define um valor que indica se o trabalho de impressão deve ser cancelado. |
Graphics |
Obtém o Graphics usado para pintar a página. |
HasMorePages |
Obtém ou define um valor que indica se uma página adicional deve ser impressa. |
MarginBounds |
Obtém a área retangular que representa a parte da página dentro das margens. |
PageBounds |
Obtém a área retangular que representa a área total da página. |
PageSettings |
Obtém as configurações de página da página atual. |
Métodos
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |