PrintForm.PrintFileName (Propiedad)

Artículo
09/04/2008

Actualización: noviembre 2007

Obtiene o establece el nombre de archivo de un archivo PostScript encapsulado y la ruta de acceso en la que se guardará el archivo cuando la propiedad PrintAction se establece en PrintToFile.

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

Sintaxis

<BrowsableAttribute(True)> _
Public Property PrintFileName As String

Dim instance As PrintForm
Dim value As String

value = instance.PrintFileName

instance.PrintFileName = value

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

[BrowsableAttribute(true)]
public:
property String^ PrintFileName {
    String^ get ();
    void set (String^ value);
}

public function get PrintFileName () : String
public function set PrintFileName (value : String)

Valor de propiedad

Tipo: System.String

Devuelve un valor de tipo String que contiene una ruta de acceso y un nombre de archivo.

Comentarios

Cuando la propiedad PrintAction se establece en PrintToFile, se guardará una imagen de un formulario en un archivo PostScript encapsulado (.eps, .ps o .ai). La propiedad PrintFileName especifica la ruta de acceso al archivo.

Nota:
Para permitir que otras aplicaciones reconozcan el archivo como un archivo PostScript, se debe usar una extensión de nombre de archivo PostScript válida (.eps, .ps o .ai) en la propiedad PrintFileName.

Si no se especifica PrintFileName, se solicitará al usuario un nombre de archivo en tiempo de ejecución.

Nota No se solicitará 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 explica cómo mostrar un cuadro de diálogo para solicitar al usuario un nombre de archivo y, a continuación, asignarlo a la propiedad PrintFileName. Este ejemplo requiere que exista un componente PrintForm denominado PrintForm1 en un formulario.

Dim fileDialog As New Windows.Forms.SaveFileDialog
Dim fileToSave As String
fileDialog.Title = "Save to PostScript file"
fileDialog.AddExtension = True
fileDialog.Filter = "Encapsulated PostScript (*.eps)|"
fileDialog.InitialDirectory = _
  My.Computer.FileSystem.SpecialDirectories.CurrentUserApplicationData
fileDialog.ShowDialog()
fileToSave = fileDialog.FileName & ".eps"
PrintForm1.PrintFileName = filePath

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.