revisions contributed by Utensil Candel

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

interface/pickerbase.h

@@ -11,13 +11,13 @@
     @wxheader{pickerbase.h}
 
     Base abstract class for all pickers which support an auxiliary text control.
+
     This class handles all positioning and sizing of the text control like a
-    an horizontal wxBoxSizer would do, with the text control on
-    the left of the picker button.
-    The proportion (see wxSizer documentation for more info about
-    proportion values) of the picker control defaults to 1 when there isn't a text
-    control
-    associated (see @c wxPB_USE_TEXTCTRL style) and to 0 otherwise.
+    an horizontal wxBoxSizer would do, with the text control on the left of the
+    picker button.
+    The proportion (see wxSizer documentation for more info about proportion values)
+    of the picker control defaults to 1 when there isn't a text control associated
+    (see @c wxPB_USE_TEXTCTRL style) and to 0 otherwise.
 
     @beginStyleTable
     @style{wxPB_USE_TEXTCTRL}:
@@ -26,7 +26,7 @@
     @endStyleTable
 
     @library{wxcore}
-    @category{FIXME}
+    @category{pickers}
 
     @see wxColourPickerCtrl
 */
@@ -35,6 +35,7 @@ class wxPickerBase : public wxControl
 public:
     /**
         Returns the margin (in pixel) between the picker and the text control.
+
         This function can be used only when HasTextCtrl() returns @true.
     */
     int GetInternalMargin() const;
@@ -46,22 +47,28 @@ public:
 
     /**
         Returns a pointer to the text control handled by this window or @NULL if the
-        @b wxPB_USE_TEXTCTRL style was not specified when this control was created.
-        Very important: the contents of the text control could be containing an invalid
-        representation of the entity which can be chosen through the picker (e.g. the user entered an invalid colour syntax because of a typo). Thus you should never parse the content of the textctrl to get the user's input; rather use the derived-class getter (e.g. wxColourPickerCtrl::GetColour, wxFilePickerCtrl::GetPath, etc).
+        @c wxPB_USE_TEXTCTRL style was not specified when this control was created.
+
+        @remarks
+        The contents of the text control could be containing an invalid
+        representation of the entity which can be chosen through the picker
+        (e.g. the user entered an invalid colour syntax because of a typo).
+        Thus you should never parse the content of the textctrl to get the
+        user's input; rather use the derived-class getter
+        (e.g. wxColourPickerCtrl::GetColour(), wxFilePickerCtrl::GetPath(), etc).
     */
     wxTextCtrl* GetTextCtrl();
 
     /**
         Returns the proportion value of the text control.
+
         This function can be used only when HasTextCtrl() returns @true.
     */
     int GetTextCtrlProportion() const;
 
     /**
-        Returns @true if this window has a valid text control (i.e. if the @b
-        wxPB_USE_TEXTCTRL style was
-        given when creating this control).
+        Returns @true if this window has a valid text control (i.e. if the @c
+        wxPB_USE_TEXTCTRL style was given when creating this control).
     */
     bool HasTextCtrl() const;
 
@@ -72,12 +79,14 @@ public:
 
     /**
         Returns @true if the text control is growable.
+
         This function can be used only when HasTextCtrl() returns @true.
     */
     bool IsTextCtrlGrowable() const;
 
     /**
         Sets the margin (in pixel) between the picker and the text control.
+
         This function can be used only when HasTextCtrl() returns @true.
     */
     void SetInternalMargin(int margin);
@@ -89,18 +98,21 @@ public:
 
     /**
         Sets the proportion value of the picker.
+
         Look at the overview of wxPickerBase for more details about this.
     */
     void SetPickerCtrlProportion(int prop);
 
     /**
         Sets the text control as growable when @c grow is @true.
+
         This function can be used only when HasTextCtrl() returns @true.
     */
     void SetTextCtrlGrowable(bool grow = true);
 
     /**
         Sets the proportion value of the text control.
+
         Look at the overview of wxPickerBase for more details about this.
         This function can be used only when HasTextCtrl() returns @true.
     */