PageSettings Classe

Definição

Espaço de Nomes:
System.Drawing.Printing
Assemblagem:
System.Drawing.dll

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

public ref class PageSettings : ICloneable
[System.Runtime.InteropServices.ComVisible(false)]
public class PageSettings : ICloneable
[System.Serializable]
public class PageSettings : 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
Object
PageSettings
Atributos
ComVisibleAttribute SerializableAttribute
Implementações
ICloneable

Exemplos

O exemplo seguinte demonstra como lidar com o PrintPage evento e verificar o PageSettings argumento de PrintPageEventArgs. Para usar este código, adicione um componente PrintDocument chamado PrintDocument1 a um formulário Windows e associe o seu evento PrintPage ao método printDocument1_PrintPage 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

Observações

A PageSettings classe é usada para especificar definições que modificam a forma como uma página será impressa. Normalmente, defines as definições padrão para que todas as páginas sejam impressas através da PrintDocument.DefaultPageSettings propriedade. Para especificar definições página a página, tratar o PrintDocument.PrintPage evento ou PrintDocument.QueryPageSettings e modificar o PageSettings argumento incluído no PrintPageEventArgs ou QueryPageSettingsEventArgs, respetivamente.

Para mais informações sobre a gestão PrintDocument de eventos, consulte a visão geral da PrintDocument aula. Para mais informações sobre impressão, consulte a visão geral do System.Drawing.Printing namespace.

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.

Construtores

Name Description
PageSettings()

Inicializa uma nova instância da PageSettings classe usando a impressora predefinida.
PageSettings(PrinterSettings)

Inicializa uma nova instância da PageSettings classe usando uma impressora especificada.

Propriedades

Name Description
Bounds

Obtém o tamanho da página, tendo em conta a orientação da página especificada pela Landscape propriedade.
Color

Recebe ou define um valor que indica se a página deve ser impressa a cores.
HardMarginX

Obtém a coordenada x, em centésimos de polegada, da margem rígida à esquerda da página.
HardMarginY

Obtém a coordenada y, em centésimos de polegada, da margem dura no topo da página.
Landscape

Recebe ou define um valor que indica se a página está impressa em orientação horizontal ou retrato.
Margins

Obtém ou define as margens desta página.
PaperSize

Obtém ou define o tamanho do papel para a página.
PaperSource

Obtém ou define a fonte em 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 definições da impressora associadas à página.

Métodos

Name Description
Clone()

Cria uma cópia deste PageSettings.
CopyToHdevmode(IntPtr)

Copia a informação relevante da PageSettings para a estrutura especificada DEVMODE .
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)
SetHdevmode(IntPtr)

Copia a informação relevante da PageSettings estrutura especificada DEVMODE .
ToString()

Converte o PageSettings para forma de cordas.

Aplica-se a

Ver também