Printer.PrintAction (Propiedad)

Artículo
09/04/2008

Actualización: noviembre 2007

Obtiene o establece un valor que determina si la salida impresa se dirige a una impresora, a una ventana de la vista previa de impresión o a un archivo.

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

Sintaxis

Public Property PrintAction As PrintAction

Dim instance As Printer
Dim value As PrintAction

value = instance.PrintAction

instance.PrintAction = value

public PrintAction PrintAction { get; set; }

public:
property PrintAction PrintAction {
    PrintAction get ();
    void set (PrintAction value);
}

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

Valor de propiedad

Tipo: System.Drawing.Printing.PrintAction

Devuelve un PrintAction de enumeración .

Comentarios

Cuando se selecciona PrintToPrinter, la salida impresa se dirige a la impresora predeterminada del equipo. Si no hay ninguna impresora instalada, se produce un error.

Cuando se selecciona PrintToPreview, la salida impresa se muestra en un control PrintPreviewDialog estándar.

Cuando se selecciona PrintToFile, la salida impresa se guarda en un archivo PostScript encapsulado (.eps, .ps o .ai) en la ruta de acceso especificada por la propiedad PrintFileName. Si no se especifica ningún nombre de archivo, se produce un error. Los archivos se guardan con formato PostScript de escala de grises de 8 bits. No se admite el formato PostScript RGB de 24 bits.

Nota:
No se solicita al usuario una ruta de acceso ni una extensión de nombre de archivo. Para asegurarse de que el archivo tiene una ruta de acceso y una extensión válidas, puede implementar un cuadro de diálogo propio. Para ello, use un componente SaveFileDialog y asigne el valor devuelto a la propiedad PrintFileName antes de llamar al método Print.

La tabla siguiente muestra los valores PrintAction que son válidos para la propiedad PrintAction.

Nombre de la enumeración	Descripción
PrintToFile	La operación de impresión se dirige a un archivo.
PrintToPreview	La operación de impresión se dirige a un cuadro de diálogo de vista previa de impresión.
PrintToPrinter	La operación de impresión se dirige a una impresora.

Nota:
Las funciones y los objetos del espacio de nombres Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6 se proporcionan para su uso con las herramientas de actualización de Visual Basic 6.0 a Visual Basic 2008. En la mayoría de los casos, estas funciones y objetos duplican la funcionalidad que se obtiene en otros espacios de nombres de .NET Framework. Únicamente son necesarios cuando el modelo de código de Visual Basic 6.0 difiere notablemente de la implementación de .NET Framework.

Las funciones y los objetos del espacio de nombres Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6 se proporcionan para su uso con las herramientas de actualización de Visual Basic 6.0 a Visual Basic 2008. En la mayoría de los casos, estas funciones y objetos duplican la funcionalidad que se obtiene en otros espacios de nombres de .NET Framework. Únicamente son necesarios cuando el modelo de código de Visual Basic 6.0 difiere notablemente de la implementación de .NET Framework.

Ejemplos

En el ejemplo siguiente se muestra cómo establecer la propiedad PrintAction. Requiere tener tres controles RadioButton que habilitan al usuario para seleccionar un método de impresión.

Dim Printer As New Printer
If RadioButton1.Checked = True Then
    Printer.PrintAction = Printing.PrintAction.PrintToPrinter
ElseIf RadioButton2.Checked = True Then
    Printer.PrintAction = Printing.PrintAction.PrintToPreview
Else
    Printer.PrintFileName = _ My.Computer.FileSystem.SpecialDirectories.CurrentUserApplicationData _ 
    & "Form1.eps"
    Printer.PrintAction = Printing.PrintAction.PrintToFile
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.