don't include private header in a sample

[wxWidgets.git] / interface / pickerbase.h

diff --git a/interface/pickerbase.h b/interface/pickerbase.h
index 94792952fcbb11d26c9bdf8454884895e14ab2aa..8fca81bdd46efa119ced954358ce5956c35e4fe7 100644 (file)
--- a/interface/pickerbase.h
+++ b/interface/pickerbase.h
@@ -11,22 +11,23 @@
     @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}:
+    @style{wxPB_USE_TEXTCTRL}
            Creates a text control to the left of the picker which is
            completely managed by this wxPickerBase class.
     @endStyleTable
 
     @library{wxcore}
-    @category{FIXME}
+    @category{pickers}
 
     @see wxColourPickerCtrl
 */
@@ -35,6 +36,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 +48,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 +80,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,19 +99,23 @@ public:
 
     /**
         Sets the proportion value of the picker.
-        Look at the overview of wxPickerBase for more details about this.
+
+        Look at the detailed description of wxPickerBase for more info.
     */
     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.
+
+        Look at the detailed description of wxPickerBase for more info.
+
         This function can be used only when HasTextCtrl() returns @true.
     */
     void SetTextCtrlProportion(int prop);