X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/adaaa68635b4c8a4d8c5284add40366ea3eefb07..920b92a3fd568f012a8f7814d56640cb729ba993:/interface/wx/textdlg.h diff --git a/interface/wx/textdlg.h b/interface/wx/textdlg.h index fb589701c2..41df73c85c 100644 --- a/interface/wx/textdlg.h +++ b/interface/wx/textdlg.h @@ -11,18 +11,42 @@ This class represents a dialog that requests a one-line password string from the user. + It is implemented as a generic wxWidgets dialog. @library{wxbase} @category{cmndlg} - @see @ref overview_wxpasswordentrydialogoverview "wxPassowrdEntryDialog - overview" + @see @ref overview_cmndlg_password */ class wxPasswordEntryDialog : public wxTextEntryDialog { public: + /** + Constructor. + Use wxTextEntryDialog::ShowModal to show the dialog. + + @param parent + Parent window. + @param message + Message to show on the dialog. + @param caption + The caption of the dialog. + @param defaultValue + The default value, which may be the empty string. + @param style + A dialog style, specifying the buttons (wxOK, wxCANCEL) and an + optional wxCENTRE style. You do not need to specify the wxTE_PASSWORD style, + it is always applied. + @param pos + Dialog position. + */ + wxPasswordEntryDialog(wxWindow* parent, const wxString& message, + const wxString& caption = wxGetPasswordFromUserPromptStr, + const wxString& defaultValue = wxEmptyString, + long style = wxOK | wxCANCEL | wxCENTRE, + const wxPoint& pos = wxDefaultPosition); }; @@ -30,14 +54,13 @@ public: /** @class wxTextEntryDialog - This class represents a dialog that requests a one-line text string from the - user. + This class represents a dialog that requests a one-line text string from the user. It is implemented as a generic wxWidgets dialog. @library{wxbase} @category{cmndlg} - @see @ref overview_wxtextentrydialogoverview "wxTextEntryDialog overview" + @see @ref overview_cmndlg_textentry */ class wxTextEntryDialog : public wxDialog { @@ -49,18 +72,20 @@ public: Parent window. @param message Message to show on the dialog. - @param defaultValue + @param caption + The caption of the the dialog. + @param value The default value, which may be the empty string. @param style A dialog style, specifying the buttons (wxOK, wxCANCEL) - and an optional wxCENTRE style. Additionally, wxTextCtrl styles (such as - wxTE_PASSWORD) may be specified here. + and an optional wxCENTRE style. Additionally, wxTextCtrl styles + (such as wxTE_PASSWORD) may be specified here. @param pos Dialog position. */ wxTextEntryDialog(wxWindow* parent, const wxString& message, - const wxString& caption = "Please enter text", - const wxString& defaultValue = "", + const wxString& caption = wxGetTextFromUserPromptStr, + const wxString& value = wxEmptyString, long style = wxOK | wxCANCEL | wxCENTRE, const wxPoint& pos = wxDefaultPosition); @@ -71,8 +96,7 @@ public: /** Returns the text that the user has entered if the user has pressed OK, or the - original value - if the user has pressed Cancel. + original value if the user has pressed Cancel. */ wxString GetValue() const;