7c913512a4
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@52383 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
129 lines
3.7 KiB
Objective-C
129 lines
3.7 KiB
Objective-C
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: dirdlg.h
|
|
// Purpose: documentation for wxDirDialog class
|
|
// Author: wxWidgets team
|
|
// RCS-ID: $Id$
|
|
// Licence: wxWindows license
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
/**
|
|
@class wxDirDialog
|
|
@wxheader{dirdlg.h}
|
|
|
|
This class represents the directory chooser dialog.
|
|
|
|
@beginStyleTable
|
|
@style{wxDD_DEFAULT_STYLE}:
|
|
Equivalent to a combination of wxDEFAULT_DIALOG_STYLE and
|
|
wxRESIZE_BORDER (the last one is not used under wxWinCE).
|
|
@style{wxDD_DIR_MUST_EXIST}:
|
|
The dialog will allow the user to choose only an existing folder.
|
|
When this style is not given, a "Create new directory" button is
|
|
added to the dialog (on Windows) or some other way is provided to
|
|
the user to type the name of a new folder.
|
|
@style{wxDD_CHANGE_DIR}:
|
|
Change the current working directory to the directory chosen by the
|
|
user.
|
|
@endStyleTable
|
|
|
|
@library{wxcore}
|
|
@category{cmndlg}
|
|
|
|
@seealso
|
|
@ref overview_wxdirdialogoverview "wxDirDialog overview", wxFileDialog
|
|
*/
|
|
class wxDirDialog : public wxDialog
|
|
{
|
|
public:
|
|
/**
|
|
Constructor. Use ShowModal() to show
|
|
the dialog.
|
|
|
|
@param parent
|
|
Parent window.
|
|
|
|
@param message
|
|
Message to show on the dialog.
|
|
|
|
@param defaultPath
|
|
The default path, or the empty string.
|
|
|
|
@param style
|
|
The dialog style. See wxDirDialog
|
|
|
|
@param pos
|
|
Dialog position. Ignored under Windows.
|
|
|
|
@param size
|
|
Dialog size. Ignored under Windows.
|
|
|
|
@param name
|
|
The dialog name, not used.
|
|
*/
|
|
wxDirDialog(wxWindow* parent,
|
|
const wxString& message = "Choose a directory",
|
|
const wxString& defaultPath = "",
|
|
long style = wxDD_DEFAULT_STYLE,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
const wxString& name = "wxDirCtrl");
|
|
|
|
/**
|
|
Destructor.
|
|
*/
|
|
~wxDirDialog();
|
|
|
|
/**
|
|
Returns the message that will be displayed on the dialog.
|
|
*/
|
|
wxString GetMessage();
|
|
|
|
/**
|
|
Returns the default or user-selected path.
|
|
*/
|
|
wxString GetPath();
|
|
|
|
/**
|
|
Sets the message that will be displayed on the dialog.
|
|
*/
|
|
void SetMessage(const wxString& message);
|
|
|
|
/**
|
|
Sets the default path.
|
|
*/
|
|
void SetPath(const wxString& path);
|
|
|
|
/**
|
|
Shows the dialog, returning wxID_OK if the user pressed OK, and wxID_CANCEL
|
|
otherwise.
|
|
*/
|
|
int ShowModal();
|
|
};
|
|
|
|
|
|
// ============================================================================
|
|
// Global functions/macros
|
|
// ============================================================================
|
|
|
|
/**
|
|
Pops up a directory selector dialog. The arguments have the same meaning as
|
|
those of wxDirDialog::wxDirDialog(). The message is displayed at the top,
|
|
and the default_path, if specified, is set as the initial selection.
|
|
|
|
The application must check for an empty return value (if the user pressed
|
|
Cancel). For example:
|
|
@code
|
|
const wxString& dir = wxDirSelector("Choose a folder");
|
|
if ( !dir.empty() )
|
|
{
|
|
...
|
|
}
|
|
@endcode
|
|
*/
|
|
wxString wxDirSelector(const wxString& message = wxDirSelectorPromptStr,
|
|
const wxString& default_path = "",
|
|
long style = 0,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
wxWindow * parent = @NULL);
|
|
|