PrinterSettings Classe

Definição

Namespace:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Origem:

PrinterSettings.cs

Especifica informações sobre como um documento é impresso, incluindo a impressora que o imprime, ao imprimir com base em um aplicativo Windows Forms.

public ref class PrinterSettings : ICloneable

public class PrinterSettings : ICloneable

type PrinterSettings = class
    interface ICloneable

Public Class PrinterSettings
Implements ICloneable

Herança

Object

PrinterSettings

Implementações

ICloneable

Exemplos

O exemplo de código a seguir imprime um documento na impressora especificada. O exemplo tem três pré-requisitos:

• Uma variável chamada filePath foi definida como o caminho do arquivo a ser impresso.

• Um método chamado pd_PrintPage, que manipula o PrintPage evento, foi definido.

• Uma variável chamada printer foi definida como o nome da impressora.

Use os System.Drawingnamespaces , System.Drawing.Printinge System.IO para este exemplo.

public:
   void Printing( String^ printer )
   {
      try
      {
         streamToPrint = gcnew StreamReader( filePath );
         try
         {
            printFont = gcnew System::Drawing::Font( "Arial",10 );
            PrintDocument^ pd = gcnew PrintDocument;
            pd->PrintPage += gcnew PrintPageEventHandler(
               this, &Form1::pd_PrintPage );
            // Specify the printer to use.
            pd->PrinterSettings->PrinterName = printer;
            if ( pd->PrinterSettings->IsValid )
            {
               pd->Print();
            }
            else
            {
               MessageBox::Show( "Printer is invalid." );
            }
         }
         finally
         {
            streamToPrint->Close();
         }
      }
      catch ( Exception^ ex ) 
      {
         MessageBox::Show( ex->Message );
      }
   }

public void Printing(string printer) {
  try {
    streamToPrint = new StreamReader (filePath);
    try {
      printFont = new Font("Arial", 10);
      PrintDocument pd = new PrintDocument(); 
      pd.PrintPage += new PrintPageEventHandler(pd_PrintPage);
      // Specify the printer to use.
      pd.PrinterSettings.PrinterName = printer;

      if (pd.PrinterSettings.IsValid) {
         pd.Print();
      } 
      else {	
         MessageBox.Show("Printer is invalid.");
      }
    } 
    finally {
      streamToPrint.Close();
    }
  } 
  catch(Exception ex) {
    MessageBox.Show(ex.Message);
  }
}

Public Sub Printing(printer As String)
    Try
        streamToPrint = New StreamReader(filePath)
        Try
            printFont = New Font("Arial", 10)
            Dim pd As New PrintDocument()
            AddHandler pd.PrintPage, AddressOf pd_PrintPage
            ' Specify the printer to use.
            pd.PrinterSettings.PrinterName = printer

            If pd.PrinterSettings.IsValid then
               pd.Print()
            Else
               MessageBox.Show("Printer is invalid.")
            End If
        Finally
            streamToPrint.Close()
        End Try
    Catch ex As Exception
        MessageBox.Show(ex.Message)
    End Try
End Sub

Comentários

Normalmente, você acessa um PrinterSettings por meio PrintDocument.PrinterSettings de propriedades ou PageSettings.PrinterSettings para modificar as configurações da impressora. A configuração mais comum da impressora é PrinterName, que especifica a impressora para a qual imprimir.

Para obter mais informações sobre impressão com Windows Forms, consulte a visão geral do System.Drawing.Printing namespace. Se você quiser imprimir de um aplicativo Windows Presentation Foundation, consulte o System.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

PrinterSettings()

Inicializa uma nova instância da classe PrinterSettings.

Propriedades

CanDuplex	Obtém um valor que indica se a impressora dá suporte à impressão nos dois lados.
Collate	Obtém ou define um valor que indica se o documento impresso é agrupado.
Copies	Obtém ou define o número de cópias do documento a serem impressas.
DefaultPageSettings	Obtém as configurações de página padrão para essa impressora.
Duplex	Obtém ou define a configuração da impressora para imprimir nos dois lados.
FromPage	Obtém ou define o número de página da primeira página a ser impressa.
InstalledPrinters	Obtém os nomes de todas as impressoras instaladas no computador.
IsDefaultPrinter	Obtém um valor que indica se a propriedade PrinterName designa a impressora padrão, exceto quando o usuário define PrinterName explicitamente.
IsPlotter	Obtém um valor que indica se a impressora é uma plotadora.
IsValid	Obtém um valor que indica se a propriedade PrinterName designa uma impressora válida.
LandscapeAngle	Obtém o ângulo, em graus, em que a orientação retrato é girada para produzir a orientação paisagem.
MaximumCopies	Obtém o número máximo de cópias que a impressora permite ao usuário imprimir por vez.
MaximumPage	Obtém ou define o FromPage ou o ToPage máximo que pode ser selecionado em um PrintDialog.
MinimumPage	Obtém ou define o FromPage ou o ToPage mínimo que pode ser selecionado em um PrintDialog.
PaperSizes	Obtém os tamanhos de papel com suporte por essa impressora.
PaperSources	Obtém as bandejas de fonte de papel que estão disponíveis na impressora.
PrinterName	Obtém ou define o nome da impressora a ser usada.
PrinterResolutions	Obtém todas as resoluções com suporte por essa impressora.
PrintFileName	Obtém ou define o nome do arquivo, ao imprimir para um arquivo.
PrintRange	Obtém ou define os números de página que o usuário especificou para imprimir.
PrintToFile	Obtém ou define um valor que indica se a saída de impressão é enviada para um arquivo em vez de uma porta.
SupportsColor	Obtém um valor que indica se esta impressora dá suporte à impressão colorida.
ToPage	Obtém ou define o número da última página a ser impressa.

Métodos

Clone()	Cria uma cópia deste PrinterSettings.
CreateMeasurementGraphics()	Retorna um Graphics que contém informações de impressora úteis ao criar um PrintDocument.
CreateMeasurementGraphics(Boolean)	Retorna um Graphics que contém informações de impressora, especificando opcionalmente a origem nas margens.
CreateMeasurementGraphics(PageSettings)	Retorna um Graphics que contém informações de impressora associadas ao PageSettings especificado.
CreateMeasurementGraphics(PageSettings, Boolean)	Cria um Graphics associado às configurações de página especificadas e opcionalmente especificando a origem nas margens.
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)
GetHdevmode()	Cria um identificador para uma estrutura DEVMODE que corresponde às configurações da impressora.
GetHdevmode(PageSettings)	Cria um identificador para uma estrutura DEVMODE que corresponde às configurações de impressora e de página especificadas por meio do parâmetro pageSettings.
GetHdevnames()	Cria um identificador para uma estrutura DEVNAMES que corresponde às configurações da impressora.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsDirectPrintingSupported(Image)	Obtém um valor que indica se a impressora dá suporte à impressão do arquivo de imagem especificado.
IsDirectPrintingSupported(ImageFormat)	Retorna um valor que indica se a impressora dá suporte à impressão do formato de imagem especificado.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
SetHdevmode(IntPtr)	Copia as informações relevantes do identificador determinado para o PrinterSettings.
SetHdevnames(IntPtr)	Copia as informações relevantes do identificador determinado para o PrinterSettings.
ToString()	Fornece informações sobre o PrinterSettings na forma de cadeia de caracteres.

Confira também

• PrinterName
• PrinterSettings
• PrinterSettings