Share via


FileDialog Interface 

Provides file dialog box functionality similar to the functionality of the standard Open and Save dialog boxes found in Microsoft Office applications.

Namespace: Microsoft.Office.Core
Assembly: office (in office.dll)

Usage

Public Class ileDialogImplementation
    Implements FileDialog
End Class
Dim ileDialogImplementation1 As New ileDialogImplementation()

Syntax

Public Interface FileDialog
    Inherits _IMsoDispObj
public interface FileDialog : _IMsoDispObj
public interface class FileDialog : public _IMsoDispObj
public interface FileDialog implements _IMsoDispObj
public interface FileDialog implements _IMsoDispObj

Remarks

With the dialog boxes this object provides, users of your solutions can easily specify the files and folders that your solution should use.

Use the FileDialog property to return a FileDialog object. The FileDialog property is located in each individual Office application's Application object. The property takes a single argument, DialogType, that determines the type of FileDialog object that the property returns. There are four types of FileDialog objects:

  • Open dialog box - Lets users select one or more files that you can then open in the host application using the Execute method.

  • SaveAs dialog box - Lets users select a single file that you can then save the current file as using the Execute method.

  • File Picker dialog box - Lets users select one or more files. The file paths that the user selects are captured in the FileDialogSelectedItems collection.

  • Folder Picker dialog box - Lets users select a path. The path that the user selects is captured in the FileDialogSelectedItems collection.

Each host application can only instantiate a single instance of the FileDialog object. Therefore, many of the properties of the FileDialog object persist even when you create multiple FileDialog objects. Therefore, make sure that you've set all of the properties appropriately for your purpose before you display the dialog box.

In order to display a file dialog box using the FileDialog object, you must use the Show method. Once a dialog box is displayed, no code will execute until the user dismisses the dialog box.

Platforms

Development Platforms

Windows XP Home Edition, Windows XP Professional, Windows Server 2003, and Windows 2000

Target Platforms

See Also

Reference

Microsoft.Office.Core Namespace

Other Resources

FileDialog Members