X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/23324ae1c7938ba904770fc456d3c07764b9c5e9..4aa59c3df6c324a6e6f9d540eac25e88b9c28acd:/interface/control.h

diff --git a/interface/control.h b/interface/control.h
index 28de175a14..2a9f824059 100644
--- a/interface/control.h
+++ b/interface/control.h
@@ -1,6 +1,6 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        control.h
-// Purpose:     documentation for wxControl class
+// Purpose:     interface of wxControl
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license
@@ -9,54 +9,54 @@
 /**
     @class wxControl
     @wxheader{control.h}
-    
-    This is the base class for a control or "widget''.
-    
+
+    This is the base class for a control or "widget".
+
     A control is generally a small window which processes user input and/or
     displays one or more item of data.
-    
+
     @library{wxcore}
     @category{ctrl}
-    @appearance{control.png}
-    
-    @seealso
-    wxValidator
+
+    @see wxValidator
 */
 class wxControl : public wxWindow
 {
 public:
     /**
-        Simulates the effect of the user issuing a command to the item. See
-        wxCommandEvent.
+        Simulates the effect of the user issuing a command to the item.
+
+        @see wxCommandEvent
     */
     void Command(wxCommandEvent& event);
 
     /**
         Returns the control's text.
-        
-        Note that the returned string contains the mnemonics (@c  characters) if
-        any, use GetLabelText() if they are
-        undesired.
+
+        @note The returned string contains mnemonics ("&" characters) if it has
+              any, use GetLabelText() if they are undesired.
     */
-    wxString GetLabel();
+    wxString GetLabel() const;
 
-    //@{
     /**
-        Returns the control's label, or the given @e label string for the static
-        version, without the mnemonics characters.
+        Returns the control's label without mnemonics.
     */
     const wxString GetLabelText();
-        static wxString GetLabelText(const wxString& label);
-    //@}
+
+    /**
+        Returns the given @a label string without mnemonics.
+    */
+    static wxString GetLabelText(const wxString& label);
 
     /**
         Sets the item's text.
-        
-        The @c  characters in the @e label are special and indicate that the
-        following character is a mnemonic for this control and can be used to activate
-        it from the keyboard (typically by using @e Alt key in combination with
-        it). To insert a literal ampersand character, you need to double it, i.e. use 
-        @c "".
+
+        Any "&" characters in the @a label are special and indicate that the
+        following character is a mnemonic for this control and can be used to
+        activate it from the keyboard (typically by using @e Alt key in
+        combination with it). To insert a literal ampersand character, you need
+        to double it, i.e. use "&&".
     */
     void SetLabel(const wxString& label);
 };
+