PrinterSettings Clase

Definición

Especifica información sobre cómo se imprime un documento, incluida la impresora que la imprime, al imprimir desde una aplicación de Windows Forms.

public ref class PrinterSettings : ICloneable
[System.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
public class PrinterSettings : ICloneable
[System.Serializable]
public class PrinterSettings : 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 a través PrinterSettingsPrintDocument.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 .

Note

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 (Solo se admite System.Drawing.Common en Windows).

Constructores

Nombre Description
PrinterSettings()

Inicializa una nueva instancia de la clase PrinterSettings.

Propiedades

Nombre Description
CanDuplex

Obtiene un valor que indica si la impresora admite impresión de doble cara.

Collate

Obtiene o establece un valor que indica si se intercala el documento impreso.

Copies

Obtiene o establece el número de copias del documento que se van 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 la impresión de 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 PrinterName propiedad designa la impresora predeterminada, excepto cuando el usuario establece PrinterNameexplícitamente .

IsPlotter

Obtiene un valor que indica si la impresora es un trazador.

IsValid

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

LandscapeAngle

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

MaximumCopies

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

MaximumPage

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

MinimumPage

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

PaperSizes

Obtiene los tamaños de papel admitidos por esta impresora.

PaperSources

Obtiene las bandejas de origen de papel que están disponibles en la impresora.

PrinterName

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

PrinterResolutions

Obtiene todas las resoluciones admitidas por esta impresora.

PrintFileName

Obtiene o establece el nombre de archivo al imprimir en un archivo.

PrintRange

Obtiene o establece los números de página que el usuario ha especificado que se va a imprimir.

PrintToFile

Obtiene o establece un valor que indica si la salida de impresión se envía a un archivo en lugar de a un puerto.

SupportsColor

Obtiene un valor que indica si esta 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

Nombre Description
Clone()

Crea una copia de este PrinterSettingsobjeto .

CreateMeasurementGraphics()

Devuelve un Graphics objeto que contiene información de impresora que resulta útil al crear un PrintDocument.

CreateMeasurementGraphics(Boolean)

Devuelve un Graphics objeto que contiene información de impresora, especificando opcionalmente el origen en los márgenes.

CreateMeasurementGraphics(PageSettings, Boolean)

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

CreateMeasurementGraphics(PageSettings)

Devuelve un Graphics objeto que contiene información de impresora asociada al especificado PageSettings.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
GetHashCode()

Actúa como la función hash predeterminada.

(Heredado de Object)
GetHdevmode()

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

GetHdevmode(PageSettings)

Crea un identificador en una DEVMODE estructura que corresponde a la impresora y a la configuración de página especificada a través del pageSettings parámetro .

GetHdevnames()

Crea un identificador en una DEVNAMES estructura que corresponde a 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 la impresión del archivo de imagen especificado.

IsDirectPrintingSupported(ImageFormat)

Devuelve un valor que indica si la impresora admite la impresión del formato de imagen especificado.

MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
SetHdevmode(IntPtr)

Copia la información pertinente fuera del identificador especificado y en .PrinterSettings

SetHdevnames(IntPtr)

Copia la información pertinente fuera del identificador especificado y en .PrinterSettings

ToString()

Proporciona información sobre en PrinterSettings forma de cadena.

Se aplica a

Consulte también