# wx.FileDialog¶

This class represents the file chooser dialog.

The path and filename are distinct elements of a full file pathname. If path is "" the current directory will be used. If filename is "" no default filename will be supplied. The wildcard determines what files are displayed in the file selector, and file extension supplies a type extension for the required filename.

The typical usage for the open file dialog is:

def OnOpen(self, event):

if self.contentNotSaved:
if wx.MessageBox("Current content has not been saved! Proceed?", "Please confirm",
wx.ICON_QUESTION | wx.YES_NO, self) == wx.NO:
return

# otherwise ask the user what new file to open
with wx.FileDialog(self, "Open XYZ file", wildcard="XYZ files (*.xyz)|*.xyz",
style=wx.FD_OPEN | wx.FD_FILE_MUST_EXIST) as fileDialog:

if fileDialog.ShowModal() == wx.ID_CANCEL:
return     # the user changed their mind

pathname = fileDialog.GetPath()
try:
with open(pathname, 'r') as file:
except IOError:
wx.LogError("Cannot open file '%s'." % newfile)


The typical usage for the save file dialog is instead somewhat simpler:

def OnSaveAs(self, event):

with wx.FileDialog(self, "Save XYZ file", wildcard="XYZ files (*.xyz)|*.xyz",
style=wx.FD_SAVE | wx.FD_OVERWRITE_PROMPT) as fileDialog:

if fileDialog.ShowModal() == wx.ID_CANCEL:
return     # the user changed their mind

# save the current contents in the file
pathname = fileDialog.GetPath()
try:
with open(pathname, 'w') as file:
self.doSaveData(file)
except IOError:
wx.LogError("Cannot save current data in file '%s'." % pathname)


## Window Styles¶

This class supports the following styles:

• wx.FD_DEFAULT_STYLE: Equivalent to FD_OPEN .

• wx.FD_OPEN: This is an open dialog; usually this means that the default button’s label of the dialog is “Open”. Cannot be combined with FD_SAVE .

• wx.FD_SAVE: This is a save dialog; usually this means that the default button’s label of the dialog is “Save”. Cannot be combined with FD_OPEN .

• wx.FD_OVERWRITE_PROMPT: For save dialog only: prompt for a confirmation if a file will be overwritten. This style is always enabled on wxOSX and cannot be disabled.

• wx.FD_NO_FOLLOW: Directs the dialog to return the path and file name of the selected shortcut file, not its target as it does by default. Currently this flag is only implemented in wxMSW and wxOSX (where it prevents aliases from being resolved). The non-dereferenced link path is always returned, even without this flag, under Unix and so using it there doesn’t do anything. This flag was added in wxWidgets 3.1.0.

• wx.FD_FILE_MUST_EXIST: For open dialog only: the user may only select files that actually exist. Notice that under macOS the file dialog with FD_OPEN style always behaves as if this style was specified, because it is impossible to choose a file that doesn’t exist from a standard macOS file dialog.

• wx.FD_MULTIPLE: For open dialog only: allows selecting multiple files.

• wx.FD_CHANGE_DIR: Change the current working directory (when the dialog is dismissed) to the directory where the file(s) chosen by the user are.

• wx.FD_PREVIEW: Show the preview of the selected files (currently only supported by wxGTK).

• wx.FD_SHOW_HIDDEN: Show hidden files. This flag was added in wxWidgets 3.1.3

Note

All implementations of the wx.FileDialog provide a wildcard filter. Typing a filename containing wildcards (, ?) in the filename text item, and clicking on Ok, will result in only those files matching the pattern being displayed. The wildcard may be a specification for multiple types of file with a description for each, such as:

wildcard = "BMP and GIF files (*.bmp;*.gif)|*.bmp;*.gif|PNG files (*.png)|*.png"


It must be noted that wildcard support in the native Motif file dialog is quite limited: only one file type is supported, and it is displayed without the descriptive test; “BMP files (.bmp)|.bmp” is displayed as “x.bmp”, and both “BMP files (.bmp)|.bmp|GIF files (.gif)|.gif” and “Image files|.bmp;.gif” are errors. On Mac macOS in the open file dialog the filter choice box is not shown by default. Instead all given wildcards are appplied at the same time: So in the above example all bmp, gif and png files are displayed. To enforce the display of the filter choice set the corresponding wx.SystemOptions before calling the file open dialog:

wx.SystemOptions.SetOption(wx.OSX_FILEDIALOG_ALWAYS_SHOW_TYPES, 1)


But in contrast to Windows and Unix, where the file type choice filters only the selected files, on Mac macOS even in this case the dialog shows all files matching all file types. The files which does not match the currently selected file type are greyed out and are not selectable.

## Class Hierarchy¶

Inheritance diagram for class FileDialog:

wxMSW

wxMAC

wxGTK

## Methods Summary¶

 __init__ Constructor. GetClassDefaultAttributes GetCurrentlySelectedFilename Returns the path of the file currently selected in dialog. GetCurrentlySelectedFilterIndex Returns the file type filter index currently selected in dialog. GetDirectory Returns the default directory. GetExtraControl If functions SetExtraControlCreator and ShowModal were called, returns the extra window. GetFilename Returns the default filename. GetFilenames Returns a list of filenames chosen in the dialog. This function GetFilterIndex Returns the index into the list of filters supplied, optionally, in the wildcard parameter. GetMessage Returns the message that will be displayed on the dialog. GetPath Returns the full path (directory and filename) of the selected file. GetPaths Returns a list of the full paths of the files chosen. This function GetWildcard Returns the file dialog wildcard. SetDirectory Sets the default directory. SetFilename Sets the default filename. SetFilterIndex Sets the default filter index, starting from zero. SetMessage Sets the message that will be displayed on the dialog. SetPath Sets the path (the combined directory and filename that will be returned when the dialog is dismissed). SetWildcard Sets the wildcard, which can contain multiple file types, for example: “BMP files (.bmp)|.bmp|GIF files (.gif)|.gif”. ShowModal Shows the dialog, returning ID_OK if the user pressed wx.OK, and ID_CANCEL otherwise.

## Class API¶

class wx.FileDialog(Dialog)

Possible constructors:

FileDialog(parent, message=FileSelectorPromptStr,
defaultDir="", defaultFile="",
wildcard=FileSelectorDefaultWildcardStr, style=FD_DEFAULT_STYLE,
pos=DefaultPosition, size=DefaultSize, name=FileDialogNameStr)


This class represents the file chooser dialog.

### Methods¶

__init__(self, parent, message=FileSelectorPromptStr, defaultDir="", defaultFile="", wildcard=FileSelectorDefaultWildcardStr, style=FD_DEFAULT_STYLE, pos=DefaultPosition, size=DefaultSize, name=FileDialogNameStr)

Constructor.

Use ShowModal to show the dialog.

Parameters
• parent (wx.Window) – Parent window.

• message (string) – Message to show on the dialog.

• defaultDir (string) – The default directory, or the empty string.

• defaultFile (string) – The default filename, or the empty string.

• wildcard (string) – A wildcard, such as “x.x” or “BMP files (.bmp)|.bmp|GIF files (.gif)|.gif”. Note that the native Motif dialog has some limitations with respect to wildcards; see the Remarks section above.

• style (long) – A dialog style. See FD_* styles for more info.

• pos (wx.Point) – Dialog position. Not implemented.

• size (wx.Size) – Dialog size. Not implemented.

• name (string) – Dialog name. Not implemented.

static GetClassDefaultAttributes(variant=WINDOW_VARIANT_NORMAL)
Parameters

variant (WindowVariant) –

Return type

wx.VisualAttributes

GetCurrentlySelectedFilename(self)

Returns the path of the file currently selected in dialog.

Notice that this file is not necessarily going to be accepted by the user, so calling this function mostly makes sense from an update UI event handler of a custom file dialog extra control to update its state depending on the currently selected file.

Currently this function is fully implemented under GTK and MSW and always returns an empty string elsewhere.

Return type

string

Returns

The path of the currently selected file or an empty string if nothing is selected.

New in version 2.9.5.

SetExtraControlCreator

GetCurrentlySelectedFilterIndex(self)

Returns the file type filter index currently selected in dialog.

Notice that this file type filter is not necessarily going to be the one finally accepted by the user, so calling this function mostly makes sense from an update UI event handler of a custom file dialog extra control to update its state depending on the currently selected file type filter.

Currently this function is fully implemented only under MSW and always returns NOT_FOUND elsewhere.

Return type

int

Returns

The 0-based index of the currently selected file type filter or wx.NOT_FOUND if nothing is selected.

New in version 4.1/wxWidgets-3.1.3.

SetExtraControlCreator

GetDirectory(self)

Returns the default directory.

Return type

string

GetExtraControl(self)

If functions SetExtraControlCreator and ShowModal were called, returns the extra window.

Otherwise returns None.

Return type

wx.Window

New in version 2.9.0.

GetFilename(self)

Returns the default filename.

Return type

string

Note

This function can’t be used with dialogs which have the FD_MULTIPLE style, use GetFilenames instead.

GetFilenames(self)

Returns a list of filenames chosen in the dialog. This function should only be used with the dialogs which have wx.MULTIPLE style, use GetFilename for the others.

Return type

list of strings

GetFilterIndex(self)

Returns the index into the list of filters supplied, optionally, in the wildcard parameter.

Before the dialog is shown, this is the index which will be used when the dialog is first displayed.

After the dialog is shown, this is the index selected by the user.

Return type

int

GetMessage(self)

Returns the message that will be displayed on the dialog.

Return type

string

GetPath(self)

Returns the full path (directory and filename) of the selected file.

Return type

string

Note

This function can’t be used with dialogs which have the FD_MULTIPLE style, use GetPaths instead.

GetPaths(self)

Returns a list of the full paths of the files chosen. This function should only be used with the dialogs which have wx.MULTIPLE style, use GetPath for the others.

Return type

list of strings

GetWildcard(self)

Returns the file dialog wildcard.

Return type

string

SetDirectory(self, directory)

Sets the default directory.

Parameters

directory (string) –

SetFilename(self, setfilename)

Sets the default filename.

In wxGTK this will have little effect unless a default directory has previously been set.

Parameters

setfilename (string) –

SetFilterIndex(self, filterIndex)

Sets the default filter index, starting from zero.

Parameters

filterIndex (int) –

SetMessage(self, message)

Sets the message that will be displayed on the dialog.

Parameters

message (string) –

SetPath(self, path)

Sets the path (the combined directory and filename that will be returned when the dialog is dismissed).

Parameters

path (string) –

SetWildcard(self, wildCard)

Sets the wildcard, which can contain multiple file types, for example: “BMP files (.bmp)|.bmp|GIF files (.gif)|.gif”.

Note that the native Motif dialog has some limitations with respect to wildcards; see the Remarks section above.

Parameters

wildCard (string) –

ShowModal(self)

Shows the dialog, returning ID_OK if the user pressed wx.OK, and ID_CANCEL otherwise.

Return type

int

### Properties¶

CurrentlySelectedFilename

CurrentlySelectedFilterIndex

Directory

ExtraControl

Filename

Filenames

FilterIndex

Message

Path

Paths

Wildcard