// Modified by:
// Created: 22.10.99
// RCS-ID: $Id$
-// Copyright: (c) wxWindows team
+// Copyright: (c) wxWidgets team
// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
#ifndef _WX_CTRLSUB_H_BASE_
#define _WX_CTRLSUB_H_BASE_
-#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
- #pragma interface "controlwithitems.h"
-#endif
+#include "wx/defs.h"
#if wxUSE_CONTROLS
// wxItemContainer defines an interface which is implemented by all controls
// which have string subitems each of which may be selected.
//
+// It is decomposed in wxItemContainerImmutable which omits all methods
+// adding/removing items and is used by wxRadioBox and wxItemContainer itself.
+//
// Examples: wxListBox, wxCheckListBox, wxChoice and wxComboBox (which
// implements an extended interface deriving from this one)
// ----------------------------------------------------------------------------
-class WXDLLEXPORT wxItemContainer
+class WXDLLEXPORT wxItemContainerImmutable
+{
+public:
+ wxItemContainerImmutable() { }
+ virtual ~wxItemContainerImmutable();
+
+ // accessing strings
+ // -----------------
+
+ virtual int GetCount() const = 0;
+ bool IsEmpty() const { return GetCount() == 0; }
+
+ virtual wxString GetString(int n) const = 0;
+ wxArrayString GetStrings() const;
+ virtual void SetString(int n, const wxString& s) = 0;
+
+ // finding string natively is either case sensitive or insensitive
+ // but never both so fall back to this base version for not
+ // supported search type
+ virtual int FindString(const wxString& s, bool bCase = false) const
+ {
+ int count = GetCount();
+
+ for ( int i = 0; i < count ; i ++ )
+ {
+ if (GetString(i).IsSameAs( s , bCase ))
+ return i;
+ }
+
+ return wxNOT_FOUND;
+ }
+
+
+ // selection
+ // ---------
+
+ virtual void SetSelection(int n) = 0;
+ virtual int GetSelection() const = 0;
+
+ // set selection to the specified string, return false if not found
+ bool SetStringSelection(const wxString& s);
+
+ // return the selected string or empty string if none
+ wxString GetStringSelection() const;
+
+ // this is the same as SetSelection( for single-selection controls but
+ // reads better for multi-selection ones
+ void Select(int n) { SetSelection(n); }
+
+
+protected:
+
+ // check that the index is valid
+ inline bool IsValid(int n) const { return n >= 0 && n < GetCount(); }
+};
+
+class WXDLLEXPORT wxItemContainer : public wxItemContainerImmutable
{
public:
wxItemContainer() { m_clientDataItemsType = wxClientData_None; }
// only for rtti needs (separate name)
void AppendString( const wxString& item)
- { Append( item ) ; }
+ { Append( item ); }
// append several items at once to the control
void Append(const wxArrayString& strings);
virtual void Clear() = 0;
virtual void Delete(int n) = 0;
- // accessing strings
- // -----------------
-
- virtual int GetCount() const = 0;
- bool IsEmpty() const { return GetCount() == 0; }
-
- virtual wxString GetString(int n) const = 0;
- wxArrayString GetStrings() const;
- virtual void SetString(int n, const wxString& s) = 0;
- virtual int FindString(const wxString& s) const = 0;
-
- // selection
- // ---------
-
- virtual void Select(int n) = 0;
- virtual int GetSelection() const = 0;
-
- wxString GetStringSelection() const;
-
// misc
// ----
bool HasClientUntypedData() const
{ return m_clientDataItemsType == wxClientData_Void; }
-#if WXWIN_COMPATIBILITY_2_2
- // compatibility - these functions are deprecated, use the new ones
- // instead
- int Number() const { return GetCount(); }
-#endif // WXWIN_COMPATIBILITY_2_2
-
protected:
virtual int DoAppend(const wxString& item) = 0;
virtual int DoInsert(const wxString& item, int pos) = 0;
// colour
virtual bool ShouldInheritColours() const { return false; }
+protected:
+ // we can't compute our best size before the items are added to the control
+ // which is done after calling SetInitialBestSize() (it is called from the
+ // base class ctor and the items are added in the derived class ctor), so
+ // don't do anything at all here as our size will be changed later anyhow
+ //
+ // of course, all derived classes *must* call SetBestSize() from their
+ // ctors for this to work!
+ virtual void SetInitialBestSize(const wxSize& WXUNUSED(size)) { }
+
private:
+ DECLARE_ABSTRACT_CLASS(wxControlWithItems)
DECLARE_NO_COPY_CLASS(wxControlWithItems)
};
+
+// ----------------------------------------------------------------------------
+// inline functions
+// ----------------------------------------------------------------------------
+
#endif // wxUSE_CONTROLS
#endif // _WX_CTRLSUB_H_BASE_
-