interface/control.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        control.h
   3 // Purpose:     documentation for wxControl class
   4 // Author:      wxWidgets team
   5 // RCS-ID:      $Id$
   6 // Licence:     wxWindows license
   7 /////////////////////////////////////////////////////////////////////////////
   8
   9 /**
  10     @class wxControl
  11     @wxheader{control.h}
  12
  13     This is the base class for a control or "widget''.
  14
  15     A control is generally a small window which processes user input and/or
  16     displays one or more item of data.
  17
  18     @library{wxcore}
  19     @category{ctrl}
  20     @appearance{control.png}
  21
  22     @seealso
  23     wxValidator
  24 */
  25 class wxControl : public wxWindow
  26 {
  27 public:
  28     /**
  29         Simulates the effect of the user issuing a command to the item. See
  30         wxCommandEvent.
  31     */
  32     void Command(wxCommandEvent& event);
  33
  34     /**
  35         Returns the control's text.
  36
  37         Note that the returned string contains the mnemonics (@c  characters) if
  38         any, use GetLabelText() if they are
  39         undesired.
  40     */
  41     wxString GetLabel();
  42
  43     //@{
  44     /**
  45         Returns the control's label, or the given @e label string for the static
  46         version, without the mnemonics characters.
  47     */
  48     const wxString GetLabelText();
  49     static wxString GetLabelText(const wxString& label);
  50     //@}
  51
  52     /**
  53         Sets the item's text.
  54
  55         The @c  characters in the @e label are special and indicate that the
  56         following character is a mnemonic for this control and can be used to activate
  57         it from the keyboard (typically by using @e Alt key in combination with
  58         it). To insert a literal ampersand character, you need to double it, i.e. use
  59         @c "".
  60     */
  61     void SetLabel(const wxString& label);
  62 };