PageSettings Classe

Definição

Especifica as configurações que se aplicam a uma única página impressa.Specifies settings that apply to a single, printed page.

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

Exemplos

O exemplo a seguir demonstra como tratar o evento PrintPage e verificar o argumento PageSettings de PrintPageEventArgs.The following example demonstrates handling the PrintPage event and checking the PageSettings argument of PrintPageEventArgs. Para usar esse código, adicione um componente de PrintDocument chamado PrintDocument1 a um formulário do Windows e associe seu evento de PrintPage com o método printDocument1_PrintPage no exemplo.To use this code, add a PrintDocument component named PrintDocument1 to a Windows Form and associate its PrintPage event with the printDocument1_PrintPage method in the example.

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 classe PageSettings é usada para especificar as configurações que modificam a maneira como uma página será impressa.The PageSettings class is used to specify settings that modify the way a page will be printed. Normalmente, você define as configurações padrão para todas as páginas a serem impressas por meio da propriedade PrintDocument.DefaultPageSettings.Typically, you set default settings for all pages to be printed through the PrintDocument.DefaultPageSettings property. Para especificar as configurações de uma base página por página, manipule o evento PrintDocument.PrintPage ou PrintDocument.QueryPageSettings e modifique o argumento PageSettings incluído no PrintPageEventArgs ou QueryPageSettingsEventArgs, respectivamente.To specify settings on a page-by-page basis, handle the PrintDocument.PrintPage or PrintDocument.QueryPageSettings event and modify the PageSettings argument included in the PrintPageEventArgs or QueryPageSettingsEventArgs, respectively.

Para obter mais informações sobre como manipular eventos de PrintDocument, consulte a visão geral da classe PrintDocument.For more information about handling PrintDocument events, see the PrintDocument class overview. Para obter mais informações sobre impressão, consulte a visão geral do namespace System.Drawing.Printing.For more information about printing, see the System.Drawing.Printing namespace overview.

Construtores

PageSettings()

Inicializa uma nova instância da classe PageSettings usando a impressora padrão.Initializes a new instance of the PageSettings class using the default printer.

PageSettings(PrinterSettings)

Inicializa uma nova instância da classe PageSettings usando a impressora especificada.Initializes a new instance of the PageSettings class using a specified printer.

Propriedades

Bounds

Obtém o tamanho da página, levando em consideração a orientação de página especificada pela propriedade Landscape.Gets the size of the page, taking into account the page orientation specified by the Landscape property.

Color

Obtém ou define um valor que indica se a página deve ser impressa colorida.Gets or sets a value indicating whether the page should be printed in color.

HardMarginX

Obtém a coordenada X, em centésimos de polegada, da margem física à esquerda da página.Gets the x-coordinate, in hundredths of an inch, of the hard margin at the left of the page.

HardMarginY

Obtém a coordenada y, em centésimos de polegada, da margem física no alto da página.Gets the y-coordinate, in hundredths of an inch, of the hard margin at the top of the page.

Landscape

Obtém ou define um valor que indica se a página é impressa com orientação de paisagem ou de retrato.Gets or sets a value indicating whether the page is printed in landscape or portrait orientation.

Margins

Obtém ou define as margens dessa página.Gets or sets the margins for this page.

PaperSize

Obtém ou define o tamanho do papel para a página.Gets or sets the paper size for the page.

PaperSource

Obtém ou define a fonte de papel da página; por exemplo, a bandeja superior da impressora.Gets or sets the page's paper source; for example, the printer's upper tray.

PrintableArea

Obtém os limites da área imprimível da página para a impressora.Gets the bounds of the printable area of the page for the printer.

PrinterResolution

Obtém ou define a resolução da impressora para a página.Gets or sets the printer resolution for the page.

PrinterSettings

Obtém ou define as configurações de impressora associadas à página.Gets or sets the printer settings associated with the page.

Métodos

Clone()

Cria uma cópia deste PageSettings.Creates a copy of this PageSettings.

CopyToHdevmode(IntPtr)

Copia as informações relevantes do PageSettings para a estrutura DEVMODE especificada.Copies the relevant information from the PageSettings to the specified DEVMODE structure.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
SetHdevmode(IntPtr)

Copia informações relevantes para o PageSettings da estrutura DEVMODE especificada.Copies relevant information to the PageSettings from the specified DEVMODE structure.

ToString()

Converte o PageSettings no formulário de cadeia de caracteres.Converts the PageSettings to string form.

Aplica-se a

Veja também