PageSettings Classe

Referência

Definição

Namespace:: System.Drawing.Printing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Pacote:: System.Drawing.Common v6.0.0

Pacote:: System.Drawing.Common v7.0.0

Pacote:: System.Drawing.Common v8.0.0

Pacote:: System.Drawing.Common v9.0.0-preview.2.24128.3

Origem:: PageSettings.cs

Origem:: PageSettings.cs

Origem:: PageSettings.cs

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.

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: Object
PageSettings

Atributos: ComVisibleAttribute SerializableAttribute

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.

Aplica-se a

Compartilhar via