solemnwarning/wxwidgets
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 4

Add wxFileDialog::AddShortcut() documentation

Browse source 
Also add a comment to the sample explaining the default behaviour.
This commit is contained in:
Vadim Zeitlin 2022-07-17 19:44:19 +01:00
parent dedd0384e6
commit 854599c0bd
2 changed files with 38 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

33
interface/wx/filedlg.h
View file

@ -232,6 +232,39 @@ public:
*/
virtual ~wxFileDialog();
/**
Add a directory to the list of shortcuts shown in the dialog.
File dialogs on many platforms display a fixed list of directories
which can be easily selected by the user. This function allows to add
an application-defined directory to this list, which can be convenient
for the programs that use specific directories for their files instead
of the default user document directory (see wxStandardPaths).
Currently this function is only implemented in wxMSW and wxGTK and does
nothing under the other platforms. Moreover, in wxMSW this function is
incompatible with the use of SetExtraControlCreator(), if you need to
use this function and customize the dialog contents, please use the
newer SetCustomizeHook() instead.
The @ref page_samples_dialogs "dialogs sample" shows the use of this
function by adding two custom shortcuts corresponding to the
subdirectories of @c WXWIN environment variable if it is defined.
@param directory The full path to the directory, which should exist.
@param flags Can be set to @c wxFD_SHORTCUT_BOTTOM (which is also the
default behaviour) to add the shortcut after the existing ones,
or @c wxFD_SHORTCUT_TOP to add it before them. Support for the
latter flag is only available in wxMSW, in wxGTK the shortcuts are
always added to the bottom of the list.
@return @true on success or @false if shortcut couldn't be added, e.g.
because this functionality is not available on the current
platform.
@since 3.3.0
*/
bool AddShortcut(const wxString& directory, int flags = 0);
/**
Returns the path of the file currently selected in dialog.

6
samples/dialogs/dialogs.cpp
View file

@ -1828,7 +1828,11 @@ void MyFrame::FileOpen(wxCommandEvent& WXUNUSED(event) )
wxString wxdir;
if ( wxGetEnv("WXWIN", &wxdir) )
{
dialog.AddShortcut(wxdir + "/src", wxFD_SHORTCUT_BOTTOM);
dialog.AddShortcut(wxdir + "/src");
// By default shortcuts are added at the bottom, but we can override
// this in the ports that support it (currently only wxMSW) and add a
// shortcut added later at the top instead.
dialog.AddShortcut(wxdir + "/include", wxFD_SHORTCUT_TOP);
}