PrintForm.PrinterSettings (Propiedad)

Artículo
09/04/2008

Actualización: noviembre 2007

Obtiene o establece un objeto PrinterSettings que se puede usar para especificar diversas propiedades de una impresora.

Espacio de nombres: Microsoft.VisualBasic.PowerPacks.Printing
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxis

<BrowsableAttribute(False)> _
Public Property PrinterSettings As PrinterSettings

Dim instance As PrintForm
Dim value As PrinterSettings

value = instance.PrinterSettings

instance.PrinterSettings = value

[BrowsableAttribute(false)]
public PrinterSettings PrinterSettings { get; set; }

[BrowsableAttribute(false)]
public:
property PrinterSettings^ PrinterSettings {
    PrinterSettings^ get ();
    void set (PrinterSettings^ value);
}

public function get PrinterSettings () : PrinterSettings
public function set PrinterSettings (value : PrinterSettings)

Valor de propiedad

Tipo: System.Drawing.Printing.PrinterSettings

Devuelve un objeto PrinterSettings.

Comentarios

Los valores de configuración devueltos por PrinterSettings son los mismos valores que se exponen a un usuario en el cuadro de diálogo Imprimir.

Se pueden especificar varios valores de configuración de impresora mediante la propiedad PrinterSettings. Por ejemplo, use la propiedad Copies para especificar el número de copias que se van a imprimir. Use la propiedad PrinterName para especificar la impresora que se va a utilizar, y la propiedad PrintRange para especificar el intervalo de páginas que se va a imprimir.

Nota:
Para permitir que el usuario seleccione los valores de configuración, puede usar un componente PrintDialog para que aparezca un cuadro de diálogo Imprimir estándar y, a continuación, asignar el valor de la propiedad PrinterSettings a la propiedad PrinterSettings.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la propiedad PrinterSettings para establecer el número de copias que se van a imprimir y comprobar si la impresora especificada es válida. Este ejemplo requiere que exista un componente PrintForm denominado PrintForm1 en un formulario.

PrintForm1.PrinterSettings.Copies = 2
If PrintForm1.PrinterSettings.IsValid Then
    PrintForm1.Print()
End If

Permisos

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.