PrinterSettings Clase

Definición

Espacio de nombres:

System.Drawing.Printing

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v8.0.0

Source:

PrinterSettings.cs

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

type PrinterSettings = class
    interface ICloneable

Public Class PrinterSettings
Implements ICloneable

Herencia

Object

PrinterSettings

Implementaciones

ICloneable

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 a PrinterSettings través PrintDocument.PrinterSettings de 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, vea System.Drawing.Common solo compatible con 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.

Consulte también

• PrinterName
• PrinterSettings
• PrinterSettings