WinFileDialogMBS.ClientGuid as String

A dialog's state can include factors such as the last visited folder and the position and size of the dialog.
Typically, this state is persisted based on the name of the executable file. By specifying a GUID, an application can have different persisted states for different versions of the dialog within the same application (for example, an import dialog and an open dialog).

SetClientGuid should be called immediately after creation of the dialog object.

Enables a calling application to associate a GUID with a dialog's persisted state.
(Read and Write property)

WinFileDialogMBS.CurrentSelection as WinShellItemMBS

The item currently selected in the dialog. This item can be a file or folder selected in the view window, or something that the user has entered into the dialog's edit box. The latter case may require a parsing operation (cancelable by the user) that blocks the current thread.

If not result exists, the plugin returns nil and raises no failed exceptions.
(Read only property)

WinFileDialogMBS.DefaultExtension as String

Dim d As WinFileOpenDialogMBS // your dialog
d.DefaultExtension = "jpg"

The extension text. This string should not include a leading period. For example, "jpg" is correct, while ".jpg" is not.

If this method is called before showing the dialog, the dialog will update the default extension automatically when the user chooses a new file type (see SetFileTypes).
(Read and Write property)

Some examples using this property:

• /WinFrameworks/Windows File Dialog

WinFileDialogMBS.DefaultFolder as WinShellItemMBS

Dim d As WinFileOpenDialogMBS // your dialog
d.DefaultFolder = New WinShellItemMBS(SpecialFolder.Desktop)

(Read and Write property)

Some examples using this property:

• /WinFrameworks/Windows File Dialog

WinFileDialogMBS.FileName as String

Dim d As WinFileOpenDialogMBS // your dialog
d.FileName = "New Document"

The text in the File name edit box does not necessarily reflect the item the user chose. To get the item the user chose, use Result property.

If not result exists, the plugin returns "" and raises no failed exceptions.
(Read and Write property)

WinFileDialogMBS.FileNameLabel as String

(Read and Write property)

Some examples using this property:

• /WinFrameworks/Windows File Dialog

WinFileDialogMBS.FileTypeIndex as Integer

The index of the selected file type in the file type array passed to SetFileTypes.

This is a one-based index rather than zero-based.
FileTypeIndex can be called either while the dialog is open or after it has closed.
(Read and Write property)

Some examples using this property:

• /WinFrameworks/Windows File Dialog

WinFileDialogMBS.Folder as WinShellItemMBS

Gets either the folder currently selected in the dialog, or, if the dialog is not currently displayed, the folder that is to be selected when the dialog is opened.

This folder overrides any "most recently used" folder. If this method is called while the dialog is displayed, it causes the dialog to navigate to the specified folder.
In general, we do not recommended the use of this method. If you call SetFolder before you display the dialog box, the most recent location that the user saved to or opened from is not shown. Unless there is a very specific reason for this behavior, it is not a good or expected user experience and should therefore be avoided. In almost all instances, SetDefaultFolder is the better method.

As of Windows 7, if the path of the folder specified through psi is the default path of a known folder, the known folder's current path is used in the dialog. That path might not be the same as the path specified in psi; for instance, if the known folder has been redirected. If the known folder is a library (virtual folders Documents, Music, Pictures, and Videos), the library's path is used in the dialog. If the specified library is hidden (as they are by default as of Windows 8.1), the library's default save location is used in the dialog, such as the Microsoft OneDrive Documents folder for the Documents library. Because of these mappings, the folder location used in the dialog might not be exactly as you specified when you called this method.
(Read and Write property)

WinFileDialogMBS.Handle as Integer

(Read and Write property)

WinFileDialogMBS.OkButtonLabel as String

Dim d As WinFileOpenDialogMBS // your dialog
d.OkButtonLabel = "Export"

(Read and Write property)

Some examples using this property:

• /WinFrameworks/Windows File Dialog

WinFileDialogMBS.OptionAllNonStorageItems as Boolean

This flag cannot be combined with OptionForceFileSystem.
(Read and Write property)

WinFileDialogMBS.OptionAllowMultiSelect as Boolean

Dim d As WinFileOpenDialogMBS // your dialog
d.OptionAllowMultiSelect = true

Note that when this flag is set, the WinFileOpenDialogMBS class must be used to retrieve those items.
(Read and Write property)

Some examples using this property:

• /WinFrameworks/Windows File Dialog

WinFileDialogMBS.OptionCreatePrompt as Boolean

Dim d As WinFileOpenDialogMBS // your dialog
d.OptionCreatePrompt = true

Note that this does not actually create the item.
(Read and Write property)

WinFileDialogMBS.OptionDefaultNoMiniMode as Boolean

Expanded mode is the mode that is set and unset by clicking the button in the lower-left corner of the Save As dialog box that switches between Browse Folders and Hide Folders when clicked. This value is not supported as of Windows 7.
(Read and Write property)

WinFileDialogMBS.OptionDontAaddToRecent as Boolean

(Read and Write property)

WinFileDialogMBS.OptionFileMustExist as Boolean

Dim d As WinFileOpenDialogMBS // your dialog
d.OptionFileMustExist = true

This is a default value for the Open dialog.
(Read and Write property)

Some examples using this property:

• /WinFrameworks/Windows File Dialog

WinFileDialogMBS.OptionForceFileSystem as Boolean

Dim d As WinFileOpenDialogMBS // your dialog
d.OptionForceFileSystem = true

Note that this does not apply to items returned by CurrentSelection.
(Read and Write property)

Some examples using this property:

• /WinFrameworks/Windows File Dialog

WinFileDialogMBS.OptionForcePreviewPaneOn as Boolean

(Read and Write property)

WinFileDialogMBS.OptionForceShowHidden as Boolean

(Read and Write property)

Some examples using this property:

• /WinFrameworks/Windows File Dialog
• /WinFrameworks/WinFileDialogObserver

WinFileDialogMBS.OptionHideMRUPlaces as Boolean

Dim d As WinFileOpenDialogMBS // your dialog
d.OptionHideMRUPlaces = true

(Read and Write property)

Some examples using this property:

• /WinFrameworks/Windows File Dialog

WinFileDialogMBS.OptionHidePinnedPlaces as Boolean

Dim d As WinFileOpenDialogMBS // your dialog
d.OptionHidePinnedPlaces = true

This flag is often used in conjunction with the AddPlace method, to hide standard locations and replace them with custom locations.

Windows 7 and later. Hide all of the standard namespace locations (such as Favorites, Libraries, Computer, and Network) shown in the navigation pane.

Windows Vista. Hide the contents of the Favorite Links tree in the navigation pane. Note that the category itself is still displayed, but shown as empty.
(Read and Write property)

WinFileDialogMBS.OptionNoChangeDir as Boolean

Dim d As WinFileOpenDialogMBS // your dialog
d.OptionNoChangeDir = true

(Read and Write property)

Some examples using this property:

• /WinFrameworks/Windows File Dialog

WinFileDialogMBS.OptionNoDereferenceLinks as Boolean

This allows an application to open a .lnk file rather than what that file is a shortcut to.
(Read and Write property)

WinFileDialogMBS.OptionNoReadOnlyReturn as Boolean

This is a default value for the Save dialog.
(Read and Write property)

WinFileDialogMBS.OptionNoTestFileCreate as Boolean

If this flag is not set, the calling application must handle errors, such as denial of access, discovered when the item is created.
(Read and Write property)

WinFileDialogMBS.OptionNoValidate as Boolean

(Read and Write property)

WinFileDialogMBS.OptionOKButtonNeedsInteraction as Boolean

(Read and Write property)

WinFileDialogMBS.OptionOverwritePrompt as Boolean

Dim d As WinFileOpenDialogMBS // your dialog
d.OptionOverwritePrompt = true

This is a default value for the Save dialog.
(Read and Write property)

Some examples using this property:

• /WinFrameworks/Windows File Dialog

WinFileDialogMBS.OptionPathMustExist as Boolean

Dim d As WinFileOpenDialogMBS // your dialog
d.OptionPathMustExist = true

This is a default value.
(Read and Write property)

Some examples using this property:

• /WinFrameworks/Windows File Dialog

WinFileDialogMBS.OptionPickFolders as Boolean

(Read and Write property)

Some examples using this property:

• /WinFrameworks/Windows File Dialog

WinFileDialogMBS.Options as Integer

See kOptions* constants.

Generally, you should read the property, modify it to include or exclude options by setting the appropriate flags and assign it again.
(Read and Write property)

WinFileDialogMBS.OptionShareaware as Boolean

This flag is overridden by kOptionsNoValidate.
(Read and Write property)

WinFileDialogMBS.OptionStrictFileTypes as Boolean

(Read and Write property)

Some examples using this property:

• /WinFrameworks/Windows File Dialog

WinFileDialogMBS.OptionSupportsStreamableItems as Boolean

(Read and Write property)

WinFileDialogMBS.ProminentControlID as Integer

Setting this property causes the control to be placed near the Open or Save button instead of being grouped with the rest of the custom controls.
Only check buttons (check boxes), push buttons, combo boxes, and menus—or a visual group that contains only a single item of one of those types—can be made prominent.
Only one control can be marked in this way. If a dialog has only one added control, that control is marked as prominent by default.
(Read and Write property)

WinFileDialogMBS.Result as WinShellItemMBS

Result can be called after the dialog has closed or during the handling of an OnFileOk event. Calling this method at any other time will fail. If multiple items were chosen, this method will fail. In the case of multiple items, call Results method.
Show must return a success code for a result to be available to Result.

If not result exists, the plugin returns nil and raises no failed exceptions.
(Read only property)

WinFileDialogMBS.Title as String

Dim d As WinFileOpenDialogMBS // your dialog
d.title = "Export database"

(Read and Write property)

WinFileDialogMBS.WindowHandle as Integer

Value is a HWND and may be used in declares.
(Read only property)