PageSettings Classe

Definição

Namespace:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Origem:

PageSettings.cs

Especifica as configurações que se aplicam a uma única página impressa.

public ref class PageSettings : ICloneable

public class PageSettings : ICloneable

type PageSettings = class
    interface ICloneable

Public Class PageSettings
Implements ICloneable

Herança

Object

PageSettings

Implementações

ICloneable

Exemplos

O exemplo a seguir demonstra como manipular o PrintPage evento e verificar o PageSettings argumento de PrintPageEventArgs. Para usar esse código, adicione um PrintDocument componente chamado PrintDocument1 a um Windows Form e associe seu PrintPage evento ao printDocument1_PrintPage método no exemplo.

private void printDocument1_PrintPage(object sender, System.Drawing.Printing.PrintPageEventArgs e)
{
    if (e.PageSettings.Color && !printDocument1.PrinterSettings.SupportsColor)
        MessageBox.Show("Color printing not supported on selected printer.", "Printer Warning", MessageBoxButtons.OKCancel);
}

Private Sub printDocument1_PrintPage(ByVal sender As Object, ByVal e As System.Drawing.Printing.PrintPageEventArgs)  Handles printDocument1.PrintPage
    If e.PageSettings.Color AndAlso Not printDocument1.PrinterSettings.SupportsColor Then
        MessageBox.Show("Color printing not supported on selected printer.", "Printer Warning", MessageBoxButtons.OKCancel)
    End If

End Sub

Comentários

A PageSettings classe é usada para especificar configurações que modificam a maneira como uma página será impressa. Normalmente, você define as configurações padrão para todas as páginas a serem impressas por meio da PrintDocument.DefaultPageSettings propriedade . Para especificar configurações de página por página, manipule o PrintDocument.PrintPage evento ou PrintDocument.QueryPageSettings e modifique o PageSettings argumento incluído no PrintPageEventArgs ou QueryPageSettingsEventArgs, respectivamente.

Para obter mais informações sobre como lidar com PrintDocument eventos, consulte a visão geral da PrintDocument classe. Para obter mais informações sobre impressão, consulte a visão geral do System.Drawing.Printing namespace.

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.

Construtores

PageSettings()	Inicializa uma nova instância da classe PageSettings usando a impressora padrão.
PageSettings(PrinterSettings)	Inicializa uma nova instância da classe PageSettings usando a impressora especificada.

Propriedades

Bounds	Obtém o tamanho da página, levando em consideração a orientação de página especificada pela propriedade Landscape.
Color	Obtém ou define um valor que indica se a página deve ser impressa colorida.
HardMarginX	Obtém a coordenada X, em centésimos de polegada, da margem física à esquerda da página.
HardMarginY	Obtém a coordenada y, em centésimos de polegada, da margem física no alto da página.
Landscape	Obtém ou define um valor que indica se a página é impressa com orientação de paisagem ou de retrato.
Margins	Obtém ou define as margens dessa página.
PaperSize	Obtém ou define o tamanho do papel para a página.
PaperSource	Obtém ou define a fonte de papel da página; por exemplo, a bandeja superior da impressora.
PrintableArea	Obtém os limites da área imprimível da página para a impressora.
PrinterResolution	Obtém ou define a resolução da impressora para a página.
PrinterSettings	Obtém ou define as configurações de impressora associadas à página.

Métodos

Clone()	Cria uma cópia deste PageSettings.
CopyToHdevmode(IntPtr)	Copia as informações relevantes do PageSettings para a estrutura DEVMODE especificada.
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)
SetHdevmode(IntPtr)	Copia informações relevantes para o PageSettings da estrutura DEVMODE especificada.
ToString()	Converte o PageSettings no formulário de cadeia de caracteres.

Confira também

• PrintDocument
• PrinterSettings