wxFileDialog

Table of Contents

wxWidgets Documentation for wxFileDialog

atom parent

sequence message [=""]

sequence defaultDir [=""]

sequence defaultFile [=""]

sequence wildcard [="*.*"]

integer style [= wxFD_DEFAULT_STYLE]

wxFD_DEFAULT_STYLE Equivalent to wxFD_OPEN.
wxFD_OPEN This is an open dialog; usually this means that the default button's label of the dialog is "Open". Cannot be combined with wxFD_SAVE.
wxFD_SAVE This is a save dialog; usually this means that the default button's label of the dialog is "Save". Cannot be combined with wxFD_OPEN.
wxFD_OVERWRITE_PROMPT For save dialog only: prompt for a confirmation if a file will be overwritten.
wxFD_FILE_MUST_EXIST For open dialog only: the user may only select files that actually exist.
wxFD_MULTIPLE For open dialog only: allows selecting multiple files.
wxFD_CHANGE_DIR Change the current working directory to the directory where the file(s) chosen by the user are.
wxFD_PREVIEW Show the preview of the selected files (currently only supported by wxGTK using GTK+ 2.4 or later).

This class represents the file chooser dialog.

Pops up a file selector box. In Windows and GTK2.4+, this is the common file selector dialog. In X, this is a file selector box with somewhat less functionality. 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.

Both the X and Windows versions implement 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:

"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 alternative is supported, and it is displayed without the descriptive test; "BMP files (*.bmp)|*.bmp'' is displayed as "*.bmp'', and both "BMP files (*.bmp)|*.bmp|GIF files (*.gif)|*.gif'' and "Image files|*.bmp;*.gif'' are errors.

Functions/Procedures

func get_fd_filename( atom fd )
func get_fd_filenames( atom fd )
func get_fd_filter_index( atom fd )
func get_fd_message( atom fd )
func get_fd_path( atom fd )
func get_fd_paths( atom fd )
func get_fd_wildcard( atom fd )
proc set_fd_directory( atom fd, object directory )
proc set_fd_filename( atom fd, object filename )
proc set_fd_filterindex( atom fd, atom filter_index )
proc set_fd_message( atom fd, object message )
proc set_fd_path( atom fd, object path )
proc set_fd_wildcard( atom fd, object wildcard )

Supertopics

Dialogs

[func]get_fd_filename ( atom fd )

wxFileDialog

[func]get_fd_filenames ( atom fd )

wxFileDialog

[func]get_fd_filter_index ( atom fd )

wxFileDialog

[func]get_fd_message ( atom fd )

wxFileDialog

[func]get_fd_path ( atom fd )

wxFileDialog

[func]get_fd_paths ( atom fd )

wxFileDialog

[func]get_fd_wildcard ( atom fd )

wxFileDialog

[proc]set_fd_directory ( atom fd, object directory )

wxFileDialog

[proc]set_fd_filename ( atom fd, object filename )

wxFileDialog

[proc]set_fd_filterindex ( atom fd, atom filter_index )

wxFileDialog

[proc]set_fd_message ( atom fd, object message )

wxFileDialog

[proc]set_fd_path ( atom fd, object path )

wxFileDialog

[proc]set_fd_wildcard ( atom fd, object wildcard )

[func]
get_fd_filename ( atom fd )

[func]
get_fd_filenames ( atom fd )

[func]
get_fd_filter_index ( atom fd )

[func]
get_fd_message ( atom fd )

[func]
get_fd_path ( atom fd )

[func]
get_fd_paths ( atom fd )

[func]
get_fd_wildcard ( atom fd )

[proc]
set_fd_directory ( atom fd, object directory )

[proc]
set_fd_filename ( atom fd, object filename )

[proc]
set_fd_filterindex ( atom fd, atom filter_index )

[proc]
set_fd_message ( atom fd, object message )

[proc]
set_fd_path ( atom fd, object path )

[proc]
set_fd_wildcard ( atom fd, object wildcard )