include/wx/combobox.h

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/combobox.h
   3 // Purpose:     wxComboBox declaration
   4 // Author:      Vadim Zeitlin
   5 // Modified by:
   6 // Created:     24.12.00
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 1996-2000 wxWidgets team
   9 // Licence:     wxWindows licence
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_COMBOBOX_H_BASE_
  13 #define _WX_COMBOBOX_H_BASE_
  14
  15 #include "wx/defs.h"
  16
  17 #if wxUSE_COMBOBOX
  18
  19 extern WXDLLIMPEXP_DATA_CORE(const char) wxComboBoxNameStr[];
  20
  21 // ----------------------------------------------------------------------------
  22 // wxComboBoxBase: this interface defines the methods wxComboBox must implement
  23 // ----------------------------------------------------------------------------
  24
  25 #include "wx/ctrlsub.h"
  26 #include "wx/textentry.h"
  27
  28 class WXDLLIMPEXP_CORE wxComboBoxBase : public wxItemContainer,
  29                                         public wxTextEntry
  30 {
  31 public:
  32     // override these methods to disambiguate between two base classes versions
  33     virtual void Clear()
  34     {
  35         wxTextEntry::Clear();
  36         wxItemContainer::Clear();
  37     }
  38
  39     // IsEmpty() is ambiguous because we inherit it from both wxItemContainer
  40     // and wxTextEntry, and even if defined it here to help the compiler with
  41     // choosing one of them, it would still be confusing for the human users of
  42     // this class. So instead define the clearly named methods below and leave
  43     // IsEmpty() ambiguous to trigger a compilation error if it's used.
  44     bool IsListEmpty() const { return wxItemContainer::IsEmpty(); }
  45     bool IsTextEmpty() const { return wxTextEntry::IsEmpty(); }
  46
  47     // also bring in GetSelection() versions of both base classes in scope
  48     //
  49     // NB: GetSelection(from, to) could be already implemented in wxTextEntry
  50     //     but still make it pure virtual because for some platforms it's not
  51     //     implemented there and also because the derived class has to override
  52     //     it anyhow to avoid ambiguity with the other GetSelection()
  53     virtual int GetSelection() const = 0;
  54     virtual void GetSelection(long *from, long *to) const = 0;
  55
  56     virtual void Popup() { wxFAIL_MSG( wxT("Not implemented") ); }
  57     virtual void Dismiss() { wxFAIL_MSG( wxT("Not implemented") ); }
  58
  59     // may return value different from GetSelection() when the combobox
  60     // dropdown is shown and the user selected, but not yet accepted, a value
  61     // different from the old one in it
  62     virtual int GetCurrentSelection() const { return GetSelection(); }
  63 };
  64
  65 // ----------------------------------------------------------------------------
  66 // include the platform-dependent header defining the real class
  67 // ----------------------------------------------------------------------------
  68
  69 #if defined(__WXUNIVERSAL__)
  70     #include "wx/univ/combobox.h"
  71 #elif defined(__WXMSW__)
  72     #include "wx/msw/combobox.h"
  73 #elif defined(__WXMOTIF__)
  74     #include "wx/motif/combobox.h"
  75 #elif defined(__WXGTK20__)
  76     #include "wx/gtk/combobox.h"
  77 #elif defined(__WXGTK__)
  78     #include "wx/gtk1/combobox.h"
  79 #elif defined(__WXMAC__)
  80     #include "wx/osx/combobox.h"
  81 #elif defined(__WXCOCOA__)
  82     #include "wx/cocoa/combobox.h"
  83 #elif defined(__WXPM__)
  84     #include "wx/os2/combobox.h"
  85 #endif
  86
  87 #endif // wxUSE_COMBOBOX
  88
  89 #endif // _WX_COMBOBOX_H_BASE_