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:
+ @code
"BMP and GIF files (*.bmp;*.gif)|*.bmp;*.gif|PNG files (*.png)|*.png"
+ @endcode
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
@library{wxcore}
@category{cmndlg}
- @see @ref overview_wxfiledialog, ::wxFileSelector()
+ @see @ref overview_cmndlg_file, ::wxFileSelector()
*/
class wxFileDialog : public wxDialog
{
Dialog name. Not implemented.
*/
wxFileDialog(wxWindow* parent,
- const wxString& message = "Choose a file",
- const wxString& defaultDir = "",
- const wxString& defaultFile = "",
- const wxString& wildcard = ".",
+ const wxString& message = wxFileSelectorPromptStr,
+ const wxString& defaultDir = wxEmptyString,
+ const wxString& defaultFile = wxEmptyString,
+ const wxString& wildcard = wxFileSelectorDefaultWildcardStr,
long style = wxFD_DEFAULT_STYLE,
const wxPoint& pos = wxDefaultPosition,
- const wxSize& sz = wxDefaultSize,
- const wxString& name = "filedlg");
+ const wxSize& size = wxDefaultSize,
+ const wxString& name = wxFileDialogNameStr);
/**
Destructor.
*/
- ~wxFileDialog();
+ virtual ~wxFileDialog();
/**
Returns the default directory.
*/
- wxString GetDirectory() const;
+ virtual wxString GetDirectory() const;
/**
If functions SetExtraControlCreator() and ShowModal() were called,
/**
Returns the default filename.
*/
- wxString GetFilename() const;
+ virtual wxString GetFilename() const;
/**
Fills the array @a filenames with the names of the files chosen.
of each referenced file by appending the directory containing the shortcuts
to the filename.
*/
- void GetFilenames(wxArrayString& filenames) const;
+ virtual void GetFilenames(wxArrayString& filenames) const;
/**
Returns the index into the list of filters supplied, optionally, in the
After the dialog is shown, this is the index selected by the user.
*/
- int GetFilterIndex() const;
+ virtual int GetFilterIndex() const;
/**
Returns the message that will be displayed on the dialog.
*/
- wxString GetMessage() const;
+ virtual wxString GetMessage() const;
/**
Returns the full path (directory and filename) of the selected file.
*/
- wxString GetPath() const;
+ virtual wxString GetPath() const;
/**
Fills the array @a paths with the full paths of the files chosen.
This function should only be used with the dialogs which have @c wxFD_MULTIPLE style,
use GetPath() for the others.
*/
- void GetPaths(wxArrayString& paths) const;
+ virtual void GetPaths(wxArrayString& paths) const;
/**
Returns the file dialog wildcard.
*/
- wxString GetWildcard() const;
+ virtual wxString GetWildcard() const;
/**
Sets the default directory.
*/
- void SetDirectory(const wxString& directory);
+ virtual void SetDirectory(const wxString& directory);
/**
Customize file dialog by adding extra window, which is typically placed
Supported platforms: wxGTK, wxUniv.
*/
- bool SetExtraControlCreator(t_extraControlCreator creator);
+ bool SetExtraControlCreator(ExtraControlCreatorFunction);
/**
Sets the default filename.
*/
- void SetFilename(const wxString& setfilename);
+ virtual void SetFilename(const wxString& setfilename);
/**
Sets the default filter index, starting from zero.
*/
- void SetFilterIndex(int filterIndex);
+ virtual void SetFilterIndex(int filterIndex);
/**
Sets the message that will be displayed on the dialog.
*/
- void SetMessage(const wxString& message);
+ virtual void SetMessage(const wxString& message);
/**
Sets the path (the combined directory and filename that will be returned when
the dialog is dismissed).
*/
- void SetPath(const wxString& path);
+ virtual void SetPath(const wxString& path);
/**
Sets the wildcard, which can contain multiple file types, for example:
Note that the native Motif dialog has some limitations with respect to
wildcards; see the Remarks section above.
*/
- void SetWildcard(const wxString& wildCard);
+ virtual void SetWildcard(const wxString& wildCard);
/**
Shows the dialog, returning wxID_OK if the user pressed OK, and wxID_CANCEL
otherwise.
*/
- int ShowModal();
+ virtual int ShowModal();
};