added interface headers with latest discussed changes

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

interface/control.h

@@ -0,0 +1,62 @@
+/////////////////////////////////////////////////////////////////////////////
+// Name:        control.h
+// Purpose:     documentation for wxControl class
+// Author:      wxWidgets team
+// RCS-ID:      $Id$
+// Licence:     wxWindows license
+/////////////////////////////////////////////////////////////////////////////
+
+/**
+    @class wxControl
+    @wxheader{control.h}
+    
+    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
+*/
+class wxControl : public wxWindow
+{
+public:
+    /**
+        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.
+    */
+    wxString GetLabel();
+
+    //@{
+    /**
+        Returns the control's label, or the given @e label string for the static
+        version, without the mnemonics characters.
+    */
+    const wxString GetLabelText();
+        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 "".
+    */
+    void SetLabel(const wxString& label);
+};