PrintForm.PrintAction (Propiedad)

Artículo
09/04/2008

Actualización: noviembre 2007

Obtiene o establece un valor que indica si el resultado se dirige a una impresora, a una ventana de vista previa de impresión o a un archivo.

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

Sintaxis

<BrowsableAttribute(True)> _
Public Property PrintAction As PrintAction

Dim instance As PrintForm
Dim value As PrintAction

value = instance.PrintAction

instance.PrintAction = value

[BrowsableAttribute(true)]
public PrintAction PrintAction { get; set; }

[BrowsableAttribute(true)]
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 una enumeración de PrintAction.

Comentarios

Cuando PrintToPrinter está seleccionado, el resultado se dirige a la impresora predeterminada del sistema. Puede invalidar este comportamiento y establecer explícitamente la impresora y las propiedades de la impresora mediante la propiedad PrinterSettings. Si no hay disponible una impresora predeterminada, se pide al usuario que seleccione una.

Cuando PrintToPreview está seleccionado, el formulario se muestra en un control PrintPreviewDialog estándar de formularios Windows Forms.

Cuando PrintToFile está seleccionado, se guarda una imagen del formulario 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 pide al usuario que indique uno.

Nota:
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.

Ejemplos

En el ejemplo siguiente se muestra cómo establecer la propiedad PrintAction. Este ejemplo requiere tener un componente PrintForm denominado PrintForm1 y tres controles RadioButton en un formulario.

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