Partilhar via


PageSettings Classe

Definição

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

public ref class PageSettings : ICloneable
public class PageSettings : ICloneable
[System.Runtime.InteropServices.ComVisible(false)]
public class PageSettings : ICloneable
[System.Serializable]
public class PageSettings : ICloneable
type PageSettings = class
    interface ICloneable
[<System.Runtime.InteropServices.ComVisible(false)>]
type PageSettings = class
    interface ICloneable
[<System.Serializable>]
type PageSettings = class
    interface ICloneable
Public Class PageSettings
Implements ICloneable
Herança
PageSettings
Atributos
Implementações

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.

Aplica-se a

Confira também