PrinterSettings Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
filePathen 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
printeren 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 |
| GetHdevmode(PageSettings) |
Crea un identificador en una |
| GetHdevnames() |
Crea un identificador en una |
| 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. |