PrinterSettings Clase

Definición

Especifica información sobre cómo se imprime un documento, incluida la impresora, desde una aplicación de formularios 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
Herencia
PrinterSettings
Atributos
Implementaciones

Ejemplos

En el ejemplo de código siguiente se imprime un documento en la impresora especificada. El ejemplo tiene tres requisitos previos:

  • Se ha establecido una variable denominada filePath en la ruta de acceso del archivo que se va a imprimir.

  • Se ha definido un método denominado pd_PrintPage, que controla el PrintPage evento .

  • Se ha establecido una variable denominada printer en el nombre de la impresora.

Use los System.Drawingespacios de nombres , System.Drawing.Printingy System.IO para este ejemplo.

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

Comentarios

Normalmente, se accede a mediante PrinterSettingsPrintDocument.PrinterSettings o PageSettings.PrinterSettings propiedades para modificar la configuración de la impresora. La configuración de impresora más común es PrinterName, que especifica la impresora en la que se va a imprimir.

Para obtener más información sobre la impresión con Windows Forms, consulte la introducción al System.Drawing.Printing espacio de nombres. Si desea imprimir desde una aplicación de Windows Presentation Foundation, consulte el System.Printing espacio de nombres .

Nota

En .NET 6 y versiones posteriores, el paquete System.Drawing.Common, que incluye este tipo, solo se admite en sistemas operativos Windows. El uso de este tipo en aplicaciones multiplataforma provoca advertencias en tiempo de compilación y excepciones en tiempo de ejecución. Para obtener más información, consulte System.Drawing.Common only supported on Windows(System.Drawing.Common only supported on Windows).

Constructores

PrinterSettings()

Inicializa una nueva instancia de la clase PrinterSettings.

Propiedades

CanDuplex

Obtiene un valor que indica si la impresora admite la impresión a dos caras.

Collate

Obtiene o establece un valor que indica si el documento imprimido está intercalado.

Copies

Obtiene o establece el número de copias del documento que se va a imprimir.

DefaultPageSettings

Obtiene la configuración de página predeterminada para esta impresora.

Duplex

Obtiene o establece la configuración de la impresora para imprimir a doble cara.

FromPage

Obtiene o establece el número de página de la primera página que se va a imprimir.

InstalledPrinters

Obtiene los nombres de todas las impresoras instaladas en el equipo.

IsDefaultPrinter

Obtiene un valor que indica si la propiedad PrinterName designa la impresora predeterminada, excepto cuando el usuario establece explícitamente la propiedad PrinterName.

IsPlotter

Obtiene un valor que indica si la impresora es de tipo plotter.

IsValid

Obtiene un valor que indica si la propiedad PrinterName designa a una impresora válida.

LandscapeAngle

Obtiene el ángulo, en grados, en que se gira la orientación vertical para obtener la orientación horizontal.

MaximumCopies

Obtiene el número máximo de copias que la impresora permite imprimir a la vez.

MaximumPage

Obtiene o establece el valor máximo de FromPage o ToPage que se puede seleccionar en PrintDialog.

MinimumPage

Obtiene o establece el valor mínimo de FromPage o ToPage que se puede seleccionar en PrintDialog.

PaperSizes

Obtiene los tamaños de papel que admite esta impresora.

PaperSources

Obtiene las bandejas fuente de papel que se encuentran disponibles en la impresora.

PrinterName

Obtiene o establece el nombre de la impresora que se va a utilizar.

PrinterResolutions

Obtiene todas las resoluciones que admite esta impresora.

PrintFileName

Obtiene o establece el nombre de archivo, cuando se imprime a un archivo.

PrintRange

Obtiene o establece los números de página que el usuario ha especificado para que se impriman.

PrintToFile

Obtiene o establece un valor que indica si el resultado de impresión se envía a un archivo en vez de a un puerto.

SupportsColor

Obtiene un valor que indica si la impresora admite la impresión en color.

ToPage

Obtiene o establece el número de la última página que se va a imprimir.

Métodos

Clone()

Crea una copia de PrinterSettings.

CreateMeasurementGraphics()

Devuelve un Graphics que contiene información de la impresora que se utiliza al crear un PrintDocument.

CreateMeasurementGraphics(Boolean)

Devuelve Graphics que contiene información de la impresora, opcionalmente se especifica el origen en los márgenes.

CreateMeasurementGraphics(PageSettings)

Devuelve Graphics que contiene información de la impresora asociada con la PageSettings especificada.

CreateMeasurementGraphics(PageSettings, Boolean)

Crea Graphics asociados con la configuración de página especificada y, opcionalmente, especifica el origen en los márgenes.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetHdevmode()

Crea un identificador que apunta a una estructura DEVMODE que se corresponde con la configuración de la impresora.

GetHdevmode(PageSettings)

Crea un identificador que apunta a una estructura DEVMODE que se corresponde con la configuración de la impresora y de la página especificadas mediante el parámetro pageSettings.

GetHdevnames()

Crea un identificador que apunta a una estructura DEVNAMES que se corresponde con la configuración de la impresora.

GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
IsDirectPrintingSupported(Image)

Obtiene un valor que indica si la impresora admite imprimir el archivo de imagen especificado.

IsDirectPrintingSupported(ImageFormat)

Devuelve un valor que indica si la impresora admite imprimir el formato de imagen especificado.

MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
SetHdevmode(IntPtr)

Copia en PrinterSettings la información relevante del identificador dado.

SetHdevnames(IntPtr)

Copia en PrinterSettings la información relevante del identificador dado.

ToString()

Proporciona información sobre el objeto PrinterSettings en formato de cadena.

Se aplica a

Consulte también