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.Specifies information about how a document is printed, including the printer that prints it, when printing from a Windows Forms application.

public ref class PrinterSettings : ICloneable
[System.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
public class PrinterSettings : ICloneable
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.The following code example prints a document on the specified printer. El ejemplo tiene tres requisitos previos:The example has three prerequisites:

  • Una variable denominada filePath se ha establecido en la ruta de acceso del archivo que se va a imprimir.A variable named filePath has been set to the path of the file to print.

  • Se ha definido pd_PrintPageun método denominado, PrintPage que controla el evento.A method named pd_PrintPage, which handles the PrintPage event, has been defined.

  • Una variable denominada printer se ha establecido en el nombre de la impresora.A variable named printer has been set to the printer's name.

Use los System.Drawingespacios System.Drawing.Printingde nombres System.IO , y para este ejemplo.Use the System.Drawing, System.Drawing.Printing, and System.IO namespaces for this example.

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 tiene acceso PrinterSettings a PrintDocument.PrinterSettings una PageSettings.PrinterSettings o a las propiedades para modificar la configuración de la impresora.Typically, you access a PrinterSettings through PrintDocument.PrinterSettings or PageSettings.PrinterSettings properties to modify printer settings. La configuración de impresora más común PrinterNamees, que especifica la impresora en la que se va a imprimir.The most common printer setting is PrinterName, which specifies the printer to print to.

Para obtener más información acerca de la impresión con Windows Forms System.Drawing.Printing , consulte la introducción a los espacios de nombres.For more information about printing with Windows Forms, see the System.Drawing.Printing namespace overview. Si desea imprimir desde una aplicación Windows Presentation Foundation, vea el System.Printing espacio de nombres.If you wish to print from a Windows Presentation Foundation application, see the System.Printing namespace.

Constructores

PrinterSettings()

Inicializa una nueva instancia de la clase PrinterSettings.Initializes a new instance of the PrinterSettings class.

Propiedades

CanDuplex

Obtiene un valor que indica si la impresora admite la impresión a dos caras.Gets a value indicating whether the printer supports double-sided printing.

Collate

Obtiene o establece un valor que indica si el documento imprimido está intercalado.Gets or sets a value indicating whether the printed document is collated.

Copies

Obtiene o establece el número de copias del documento que se va a imprimir.Gets or sets the number of copies of the document to print.

DefaultPageSettings

Obtiene la configuración de página predeterminada para esta impresora.Gets the default page settings for this printer.

Duplex

Obtiene o establece la configuración de la impresora para imprimir a doble cara.Gets or sets the printer setting for double-sided printing.

FromPage

Obtiene o establece el número de página de la primera página que se va a imprimir.Gets or sets the page number of the first page to print.

InstalledPrinters

Obtiene los nombres de todas las impresoras instaladas en el equipo.Gets the names of all printers installed on the computer.

IsDefaultPrinter

Obtiene un valor que indica si la propiedad PrinterName designa la impresora predeterminada, excepto cuando el usuario establece explícitamente la propiedad PrinterName.Gets a value indicating whether the PrinterName property designates the default printer, except when the user explicitly sets PrinterName.

IsPlotter

Obtiene un valor que indica si la impresora es de tipo plotter.Gets a value indicating whether the printer is a plotter.

IsValid

Obtiene un valor que indica si la propiedad PrinterName designa a una impresora válida.Gets a value indicating whether the PrinterName property designates a valid printer.

LandscapeAngle

Obtiene el ángulo, en grados, en que se gira la orientación vertical para obtener la orientación horizontal.Gets the angle, in degrees, that the portrait orientation is rotated to produce the landscape orientation.

MaximumCopies

Obtiene el número máximo de copias que la impresora permite imprimir a la vez.Gets the maximum number of copies that the printer enables the user to print at a time.

MaximumPage

Obtiene o establece el valor máximo de FromPage o ToPage que se puede seleccionar en PrintDialog.Gets or sets the maximum FromPage or ToPage that can be selected in a PrintDialog.

MinimumPage

Obtiene o establece el valor mínimo de FromPage o ToPage que se puede seleccionar en PrintDialog.Gets or sets the minimum FromPage or ToPage that can be selected in a PrintDialog.

PaperSizes

Obtiene los tamaños de papel que admite esta impresora.Gets the paper sizes that are supported by this printer.

PaperSources

Obtiene las bandejas fuente de papel que se encuentran disponibles en la impresora.Gets the paper source trays that are available on the printer.

PrinterName

Obtiene o establece el nombre de la impresora que se va a utilizar.Gets or sets the name of the printer to use.

PrinterResolutions

Obtiene todas las resoluciones que admite esta impresora.Gets all the resolutions that are supported by this printer.

PrintFileName

Obtiene o establece el nombre de archivo, cuando se imprime a un archivo.Gets or sets the file name, when printing to a file.

PrintRange

Obtiene o establece los números de página que el usuario ha especificado para que se impriman.Gets or sets the page numbers that the user has specified to be printed.

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.Gets or sets a value indicating whether the printing output is sent to a file instead of a port.

SupportsColor

Obtiene un valor que indica si la impresora admite la impresión en color.Gets a value indicating whether this printer supports color printing.

ToPage

Obtiene o establece el número de la última página que se va a imprimir.Gets or sets the number of the last page to print.

Métodos

Clone()

Crea una copia de PrinterSettings.Creates a copy of this PrinterSettings.

CreateMeasurementGraphics()

Devuelve un Graphics que contiene información de la impresora que se utiliza al crear un PrintDocument.Returns a Graphics that contains printer information that is useful when creating a PrintDocument.

CreateMeasurementGraphics(Boolean)

Devuelve Graphics que contiene información de la impresora, opcionalmente se especifica el origen en los márgenes.Returns a Graphics that contains printer information, optionally specifying the origin at the margins.

CreateMeasurementGraphics(PageSettings)

Devuelve Graphics que contiene información de la impresora asociada con la PageSettings especificada.Returns a Graphics that contains printer information associated with the specified PageSettings.

CreateMeasurementGraphics(PageSettings, Boolean)

Crea Graphics asociados con la configuración de página especificada y, opcionalmente, especifica el origen en los márgenes.Creates a Graphics associated with the specified page settings and optionally specifying the origin at the margins.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetHdevmode()

Crea un identificador que apunta a una estructura DEVMODE que se corresponde con la configuración de la impresora.Creates a handle to a DEVMODE structure that corresponds to the printer settings.

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.Creates a handle to a DEVMODE structure that corresponds to the printer and the page settings specified through the pageSettings parameter.

GetHdevnames()

Crea un identificador que apunta a una estructura DEVNAMES que se corresponde con la configuración de la impresora.Creates a handle to a DEVNAMES structure that corresponds to the printer settings.

GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
IsDirectPrintingSupported(Image)

Obtiene un valor que indica si la impresora admite imprimir el archivo de imagen especificado.Gets a value indicating whether the printer supports printing the specified image file.

IsDirectPrintingSupported(ImageFormat)

Devuelve un valor que indica si la impresora admite imprimir el formato de imagen especificado.Returns a value indicating whether the printer supports printing the specified image format.

MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
SetHdevmode(IntPtr)

Copia en PrinterSettings la información relevante del identificador dado.Copies the relevant information out of the given handle and into the PrinterSettings.

SetHdevnames(IntPtr)

Copia en PrinterSettings la información relevante del identificador dado.Copies the relevant information out of the given handle and into the PrinterSettings.

ToString()

Proporciona información sobre el objeto PrinterSettings en formato de cadena.Provides information about the PrinterSettings in string form.

Se aplica a

Consulte también: