give a name to the unnamed enum to make it easier to document it

[wxWidgets.git] / include / wx / combobox.h

diff --git a/include/wx/combobox.h b/include/wx/combobox.h
index 26512aa0cd5460a5e01da7dbd269b946e2329a57..ce7ba61aeebc1a093706212e5138f7de6e904b34 100644 (file)
--- a/include/wx/combobox.h
+++ b/include/wx/combobox.h
@@ -1,19 +1,80 @@
+///////////////////////////////////////////////////////////////////////////////
+// Name:        wx/combobox.h
+// Purpose:     wxComboBox declaration
+// Author:      Vadim Zeitlin
+// Modified by:
+// Created:     24.12.00
+// RCS-ID:      $Id$
+// Copyright:   (c) 1996-2000 wxWidgets team
+// Licence:     wxWindows licence
+///////////////////////////////////////////////////////////////////////////////
+
 #ifndef _WX_COMBOBOX_H_BASE_
 #define _WX_COMBOBOX_H_BASE_
 
-#if defined(__WXMSW__)
-#include "wx/msw/combobox.h"
+#include "wx/defs.h"
+
+#if wxUSE_COMBOBOX
+
+extern WXDLLIMPEXP_DATA_CORE(const char) wxComboBoxNameStr[];
+
+// ----------------------------------------------------------------------------
+// wxComboBoxBase: this interface defines the methods wxComboBox must implement
+// ----------------------------------------------------------------------------
+
+#include "wx/ctrlsub.h"
+#include "wx/textentry.h"
+
+class WXDLLIMPEXP_CORE wxComboBoxBase : public wxItemContainer,
+                                   public wxTextEntry
+{
+public:
+    // override these methods to disambiguate between two base classes versions
+    virtual void Clear()
+    {
+        wxTextEntry::Clear();
+        wxItemContainer::Clear();
+    }
+
+    bool IsEmpty() const { return wxItemContainer::IsEmpty(); }
+
+    // also bring in GetSelection() versions of both base classes in scope
+    //
+    // NB: GetSelection(from, to) could be already implemented in wxTextEntry
+    //     but still make it pure virtual because for some platforms it's not
+    //     implemented there and also because the derived class has to override
+    //     it anyhow to avoid ambiguity with the other GetSelection()
+    virtual int GetSelection() const = 0;
+    virtual void GetSelection(long *from, long *to) const = 0;
+
+    // may return value different from GetSelection() when the combobox
+    // dropdown is shown and the user selected, but not yet accepted, a value
+    // different from the old one in it
+    virtual int GetCurrentSelection() const { return GetSelection(); }
+};
+
+// ----------------------------------------------------------------------------
+// include the platform-dependent header defining the real class
+// ----------------------------------------------------------------------------
+
+#if defined(__WXUNIVERSAL__)
+    #include "wx/univ/combobox.h"
+#elif defined(__WXMSW__)
+    #include "wx/msw/combobox.h"
 #elif defined(__WXMOTIF__)
-#include "wx/motif/combobox.h"
+    #include "wx/motif/combobox.h"
+#elif defined(__WXGTK20__)
+    #include "wx/gtk/combobox.h"
 #elif defined(__WXGTK__)
-#include "wx/gtk/combobox.h"
-#elif defined(__WXQT__)
-#include "wx/qt/combobox.h"
+    #include "wx/gtk1/combobox.h"
 #elif defined(__WXMAC__)
-#include "wx/mac/combobox.h"
-#elif defined(__WXSTUBS__)
-#include "wx/stubs/combobox.h"
+    #include "wx/mac/combobox.h"
+#elif defined(__WXCOCOA__)
+    #include "wx/cocoa/combobox.h"
+#elif defined(__WXPM__)
+    #include "wx/os2/combobox.h"
 #endif
 
-#endif
-    // _WX_COMBOBOX_H_BASE_
+#endif // wxUSE_COMBOBOX
+
+#endif // _WX_COMBOBOX_H_BASE_