PrinterSettings Classe

Definição

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
[System.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
public class PrinterSettings : ICloneable
[System.Serializable]
public class PrinterSettings : ICloneable
type PrinterSettings = class
    interface ICloneable
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Serializable>]
type PrinterSettings = class
    interface ICloneable
[<System.Serializable>]
type PrinterSettings = class
    interface ICloneable
Public Class PrinterSettings
Implements ICloneable
Herança
PrinterSettings
Atributos
Implementações

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.

Aplica-se a

Confira também