FileDialog-Objekt (Office)

  • Artikel

Ermöglicht den Zugriff auf Dateidialogfeldfunktionalität, die der Funktionalität der Standarddialogfelder Öffnen und Speichern in Microsoft Office-Anwendungen entspricht.

Hinweise

Verwenden Sie die FileDialog-Eigenschaft, um ein FileDialog-Objekt zurückzugeben. Die FileDialog-Eigenschaft ist Bestandteil des Application-Objekts jeder einzelnen Office-Anwendung. Die -Eigenschaft verwendet ein einzelnes Argument, MsoFileDialogType, das den Typ des FileDialog-Objekts bestimmt, das die Eigenschaft zurückgibt. Es gibt vier Typen von FileDialog-Objekten:

  • Dialogfeld Öffnen: Ermöglicht dem Benutzer das Auswählen einer oder mehrerer Dateien, die dann mithilfe der Execute-Methode in der Hostanwendung geöffnet werden können.

  • Dialogfeld Speichern unter: Ermöglicht dem Benutzer das Auswählen einer Datei, als die die aktuelle Datei dann mithilfe der Execute-Methode gespeichert werden kann.

  • Dialogfeld Dateiauswahl: Ermöglicht dem Benutzer das Auswählen mindestens einer Datei. Die vom Benutzer ausgewählten Dateipfade werden in der FileDialogSelectedItems-Auflistung erfasst.

  • Dialogfeld Ordnerauswahl: Ermöglicht dem Benutzer das Auswählen mindestens eines Pfads. Die vom Benutzer ausgewählten Pfade werden in der FileDialogSelectedItems-Auflistung erfasst.

Jede Hostanwendung kann nur eine einzige Instanz des FileDialog-Objekts erstellen. Dadurch bleiben viele Eigenschaften des FileDialog-Objekts auch dann erhalten, wenn Sie mehrere FileDialog-Objekte erstellen. Prüfen Sie deshalb genau, ob alle Eigenschaften wie gewünscht festgelegt sind, bevor Sie das Dialogfeld anzeigen.

Beispiel

Zum Anzeigen eines Dateidialogfelds mithilfe des FileDialog-Objekts müssen Sie die Show-Methode verwenden. Sobald ein Dialogfeld angezeigt wird, wird kein Code ausgeführt, bis der Benutzer das Dialogfeld schließt. Im folgenden Beispiel wird das Dialogfeld Dateiauswahl erstellt und angezeigt und jede ausgewählte Datei in einem Meldungsfeld angezeigt.

Sub Main() 
 
 'Declare a variable as a FileDialog object. 
 Dim fd As FileDialog 
 
 'Create a FileDialog object as a File Picker dialog box. 
 Set fd = Application.FileDialog(msoFileDialogFilePicker) 
 
 'Declare a variable to contain the path 
 'of each selected item. Even though the path is aString, 
 'the variable must be a Variant because For Each...Next 
 'routines only work with Variants and Objects. 
 Dim vrtSelectedItem As Variant 
 
 'Use a With...End With block to reference the FileDialog object. 
 With fd 
 
 'Use the Show method to display the File Picker dialog box and return the user's action. 
 'The user pressed the button. 
 If .Show = -1 Then 
 
 'Step through each string in the FileDialogSelectedItems collection. 
 For Each vrtSelectedItem In .SelectedItems 
 
 'vrtSelectedItem is aString that contains the path of each selected item. 
 'Use any file I/O functions that you want to work with this path. 
 'This example displays the path in a message box. 
 MsgBox "The path is: " & vrtSelectedItem 
 
 Next vrtSelectedItem 
 'The user pressed Cancel. 
 Else 
 End If 
 End With 
 
 'Set the object variable to Nothing. 
 Set fd = Nothing 
 
End Sub

Siehe auch

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.