interface revisions of ta*h te*h headers; grouped wxTextAttr #defines into enums to make it easier to document them

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@56075 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

interface/wx/textdlg.h

@@ -11,18 +11,40 @@
 
     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 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 = "Enter password",
+                          const wxString& defaultValue = wxEmptyString,
+                          long style = wxOK | wxCANCEL | wxCENTRE,
+                          const wxPoint& pos = wxDefaultPosition);
 };
 
 
@@ -30,14 +52,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
 {
@@ -53,8 +74,8 @@ public:
             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.
     */
@@ -71,8 +92,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;