PrintForm.PrintFileName-Eigenschaft

Artikel
08/23/2008

Aktualisiert: November 2007

Ruft den Namen ab bzw. legt den Dateinamen einer Encapsulated PostScript-Datei sowie den Pfad fest, in dem die Datei gespeichert werden soll, wenn die PrintAction-Eigenschaft auf PrintToFile festgelegt wurde.

Namespace: Microsoft.VisualBasic.PowerPacks.Printing
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

<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)

Eigenschaftenwert

Typ: System.String

Gibt einen String zurück, der den Dateipfad und den Namen enthält.

Hinweise

Wenn die PrintAction-Eigenschaft auf PrintToFile festgelegt ist, wird das Bild eines Formulars in einer Encapsulated PostScript-Datei (.eps, .ps oder .ai) gespeichert. Von der PrintFileName-Eigenschaft wird der Pfad zu der Datei festgelegt.

Hinweis:
Sie müssen in der PrintFileName-Eigenschaft eine gültige PostScript-Dateinamenerweiterung (.eps, .ps oder .ai) verwenden, sodass die Datei von anderen Anwendungen als PostScript-Datei erkannt werden kann.

Wenn kein PrintFileName festgelegt ist, wird der Benutzer zur Laufzeit zur Eingabe eines Dateinamens aufgefordert.

Hinweis Der Benutzer wird nicht zur Eingabe eines Pfads oder einer Dateinamenerweiterung aufgefordert. Um sicherzustellen, dass die Datei über einen gültigen Pfad und eine gültige Erweiterung verfügt, können Sie ein eigenes Dialogfeld implementieren. Verwenden Sie hierfür eine SaveFileDialog-Komponente, und weisen Sie den zurückgegebenen Wert der PrintFileName-Eigenschaft zu, bevor Sie die Print-Methode aufrufen.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein Dialogfeld mit der Aufforderung zur Eingabe eines Dateinamens angezeigt werden kann, der anschließend der PrintFileName-Eigenschaft zugewiesen wird. Für dieses Beispiel ist es erforderlich, dass auf einem Formular eine PrintForm-Komponente mit der Bezeichnung PrintForm1 vorhanden ist.

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

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.