PrintPageEventArgs Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece dados para o PrintPage evento.
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 seguinte assume que um Button nome printButton e um PrintDocument nome pd foram criados sobre um Form. Certifique-se de que o Click evento para o Button está associado printButton_Click ao método e o PrintPage evento de PrintDocument o está associado ao pd_PrintPage método no exemplo. O printButton_Click método do exemplo chama o Print método que gera o PrintPage evento e imprime o ficheiro .bmp especificado no pd_PrintPage método. Para executar este exemplo, altera o caminho para o bitmap que queres imprimir.
Use os System.Drawingnamespaces , System.Drawing.Printing, e 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
Observações
Note
No .NET 6 e versões posteriores, o pacote System.Drawing.Common, que inclui esse tipo, só é suportado em sistemas operacionais Windows. O uso deste tipo em aplicações multiplataforma causa avisos em tempo de compilação e exceções em tempo de execução. Para obter mais informações, consulte System.Drawing.Common suportado apenas no Windows.
A MarginBounds propriedade recupera a área retangular que representa a porção 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 que se deve fazer a pintura. A PageSettings propriedade recupera as definiçõ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 mais informações sobre impressão com Windows Forms, consulte a visão geral do espaço de nomes System.Drawing.Printing. Se quiser imprimir a partir de uma aplicação Windows Presentation Foundation, consulte o espaço de nomes System.Printing.
Construtores
| Name | Description |
|---|---|
| PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings) |
Inicializa uma nova instância da PrintPageEventArgs classe. |
Propriedades
| Name | Description |
|---|---|
| Cancel |
Recebe ou define um valor que indica se o trabalho de impressão deve ser cancelado. |
| Graphics |
É Graphics usado para pintar a página. |
| HasMorePages |
Recebe ou define um valor que indica se deve ser impressa uma página adicional. |
| 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 definições da página atual. |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |