include/wx/checkbox.h

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/checkbox.h
   3 // Purpose:     wxCheckBox class interface
   4 // Author:      Vadim Zeitlin
   5 // Modified by:
   6 // Created:     07.09.00
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) wxWindows team
   9 // Licence:     wxWindows licence
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_CHECKBOX_H_BASE_
  13 #define _WX_CHECKBOX_H_BASE_
  14
  15 #include "wx/defs.h"
  16
  17 #if wxUSE_CHECKBOX
  18
  19 #include "wx/control.h"
  20
  21
  22 /*
  23  * wxCheckBox style flags
  24  * (Using wxCHK_* because wxCB_* is used by wxComboBox).
  25  * Determine whether to use a 3-state or 2-state
  26  * checkbox. 3-state enables to differentiate
  27  * between 'unchecked', 'checked' and 'undetermined'.
  28  */
  29 #define wxCHK_2STATE           0x0000
  30 #define wxCHK_3STATE           0x1000
  31
  32 /*
  33  * If this style is set the user can set the checkbox to the
  34  * undetermined state. If not set the undetermined set can only
  35  * be set programmatically.
  36  * This style can only be used with 3 state checkboxes.
  37  */
  38 #define wxCHK_ALLOW_3RD_STATE_FOR_USER 0x2000
  39
  40 /*
  41  * The possible states of a 3-state checkbox (Compatible
  42  * with the 2-state checkbox).
  43  */
  44 enum wxCheckBoxState
  45 {
  46     wxCHK_UNCHECKED,
  47     wxCHK_CHECKED,
  48     wxCHK_UNDETERMINED /* 3-state checkbox only */
  49 };
  50
  51
  52 WXDLLEXPORT_DATA(extern const wxChar *) wxCheckBoxNameStr;
  53
  54 // ----------------------------------------------------------------------------
  55 // wxCheckBox: a control which shows a label and a box which may be checked
  56 // ----------------------------------------------------------------------------
  57
  58 class WXDLLEXPORT wxCheckBoxBase : public wxControl
  59 {
  60 public:
  61     wxCheckBoxBase() { }
  62
  63     // set/get the checked status of the listbox
  64     virtual void SetValue(bool value) = 0;
  65     virtual bool GetValue() const = 0;
  66
  67     bool IsChecked() const
  68     {
  69         wxASSERT_MSG( !Is3State(), wxT("Calling IsChecked() doesn't make sense for")
  70             wxT(" a three state checkbox, Use Get3StateValue() instead") );
  71
  72         return GetValue();
  73     }
  74
  75     wxCheckBoxState Get3StateValue() const
  76     {
  77         wxCheckBoxState state = DoGet3StateValue();
  78
  79         if ( state == wxCHK_UNDETERMINED && !Is3State() )
  80         {
  81             // Undetermined state with a 2-state checkbox??
  82             wxFAIL_MSG( wxT("DoGet3StateValue() says the 2-state checkbox is ")
  83                 wxT("in an undetermined/third state") );
  84
  85             state = wxCHK_UNCHECKED;
  86         }
  87
  88         return state;
  89     }
  90
  91     void Set3StateValue(wxCheckBoxState state)
  92     {
  93         if ( state == wxCHK_UNDETERMINED && !Is3State() )
  94         {
  95             wxFAIL_MSG(wxT("Setting a 2-state checkbox to undetermined state"));
  96             state = wxCHK_UNCHECKED;
  97         }
  98
  99         DoSet3StateValue(state);
 100     }
 101
 102     bool Is3State() const
 103     {
 104         return (m_style & wxCHK_3STATE) != 0;
 105     }
 106
 107     bool Is3rdStateAllowedForUser() const
 108     {
 109         return (m_style & wxCHK_ALLOW_3RD_STATE_FOR_USER) != 0;
 110     }
 111
 112 protected:
 113     int m_style;
 114
 115     virtual void DoSet3StateValue(wxCheckBoxState WXUNUSED(state)) { wxFAIL; }
 116
 117     virtual wxCheckBoxState DoGet3StateValue() const
 118     {
 119         wxFAIL;
 120         return wxCHK_UNCHECKED;
 121     }
 122
 123 private:
 124     DECLARE_NO_COPY_CLASS(wxCheckBoxBase)
 125 };
 126
 127 #if defined(__WXUNIVERSAL__)
 128     #include "wx/univ/checkbox.h"
 129 #elif defined(__WXMSW__)
 130     #include "wx/msw/checkbox.h"
 131 #elif defined(__WXMOTIF__)
 132     #include "wx/motif/checkbox.h"
 133 #elif defined(__WXGTK__)
 134     #include "wx/gtk/checkbox.h"
 135 #elif defined(__WXMAC__)
 136     #include "wx/mac/checkbox.h"
 137 #elif defined(__WXCOCOA__)
 138     #include "wx/cocoa/checkbox.h"
 139 #elif defined(__WXPM__)
 140     #include "wx/os2/checkbox.h"
 141 #endif
 142
 143 #endif // wxUSE_CHECKBOX
 144
 145 #endif
 146     // _WX_CHECKBOX_H_BASE_