PageSettings Classe
Definição
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
-
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 |
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 |
ToString() |
Converte o PageSettings no formulário de cadeia de caracteres. |