PrinterSettings.PrinterName Propriedade

Definição

Namespace:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Origem:

PrinterSettings.cs

Obtém ou define o nome da impressora a ser usada.

public:
 property System::String ^ PrinterName { System::String ^ get(); void set(System::String ^ value); };

public string PrinterName { get; set; }

member this.PrinterName : string with get, set

Public Property PrinterName As String

Valor da propriedade

String

O nome da impressora a ser usada.

Exemplos

O exemplo de código a seguir especifica a impressora de destino definindo a PrinterName propriedade e, se for IsValidtrue, imprime o 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

Depois de definir o nome da impressora, chame IsValid para determinar se o nome da impressora é reconhecido como uma impressora válida no sistema.

Você também pode usar a InstalledPrinters propriedade para obter uma lista de impressoras instaladas no sistema.

Confira também

• IsValid
• InstalledPrinters
• Duplex
• MaximumCopies