]>
Commit | Line | Data |
---|---|---|
1 | ///////////////////////////////////////////////////////////////////////////// | |
2 | // Name: wx/ctrlsub.h (read: "wxConTRoL with SUBitems") | |
3 | // Purpose: wxControlWithItems interface | |
4 | // Author: Vadim Zeitlin | |
5 | // Modified by: | |
6 | // Created: 22.10.99 | |
7 | // RCS-ID: $Id$ | |
8 | // Copyright: (c) wxWindows team | |
9 | // Licence: wxWindows licence | |
10 | ///////////////////////////////////////////////////////////////////////////// | |
11 | ||
12 | #ifndef _WX_CTRLSUB_H_BASE_ | |
13 | #define _WX_CTRLSUB_H_BASE_ | |
14 | ||
15 | #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA) | |
16 | #pragma interface "controlwithitems.h" | |
17 | #endif | |
18 | ||
19 | #if wxUSE_CONTROLS | |
20 | ||
21 | #include "wx/control.h" // base class | |
22 | ||
23 | // ---------------------------------------------------------------------------- | |
24 | // wxItemContainer defines an interface which is implemented by all controls | |
25 | // which have string subitems each of which may be selected. | |
26 | // | |
27 | // Examples: wxListBox, wxCheckListBox, wxChoice and wxComboBox (which | |
28 | // implements an extended interface deriving from this one) | |
29 | // ---------------------------------------------------------------------------- | |
30 | ||
31 | class WXDLLEXPORT wxItemContainer | |
32 | { | |
33 | public: | |
34 | wxItemContainer() { m_clientDataItemsType = wxClientData_None; } | |
35 | virtual ~wxItemContainer(); | |
36 | ||
37 | // adding items | |
38 | // ------------ | |
39 | ||
40 | int Append(const wxString& item) | |
41 | { return DoAppend(item); } | |
42 | int Append(const wxString& item, void *clientData) | |
43 | { int n = DoAppend(item); SetClientData(n, clientData); return n; } | |
44 | int Append(const wxString& item, wxClientData *clientData) | |
45 | { int n = DoAppend(item); SetClientObject(n, clientData); return n; } | |
46 | ||
47 | // only for rtti needs (separate name) | |
48 | void AppendString( const wxString& item) | |
49 | { Append( item ) ; } | |
50 | ||
51 | // append several items at once to the control | |
52 | void Append(const wxArrayString& strings); | |
53 | ||
54 | int Insert(const wxString& item, int pos) | |
55 | { return DoInsert(item, pos); } | |
56 | int Insert(const wxString& item, int pos, void *clientData); | |
57 | int Insert(const wxString& item, int pos, wxClientData *clientData); | |
58 | ||
59 | // deleting items | |
60 | // -------------- | |
61 | ||
62 | virtual void Clear() = 0; | |
63 | virtual void Delete(int n) = 0; | |
64 | ||
65 | // accessing strings | |
66 | // ----------------- | |
67 | ||
68 | virtual int GetCount() const = 0; | |
69 | bool IsEmpty() const { return GetCount() == 0; } | |
70 | ||
71 | virtual wxString GetString(int n) const = 0; | |
72 | wxArrayString GetStrings() const; | |
73 | virtual void SetString(int n, const wxString& s) = 0; | |
74 | virtual int FindString(const wxString& s) const = 0; | |
75 | ||
76 | // selection | |
77 | // --------- | |
78 | ||
79 | virtual void Select(int n) = 0; | |
80 | virtual int GetSelection() const = 0; | |
81 | ||
82 | wxString GetStringSelection() const; | |
83 | ||
84 | // misc | |
85 | // ---- | |
86 | ||
87 | // client data stuff | |
88 | void SetClientData(int n, void* clientData); | |
89 | void* GetClientData(int n) const; | |
90 | ||
91 | void SetClientObject(int n, wxClientData* clientData); | |
92 | wxClientData* GetClientObject(int n) const; | |
93 | ||
94 | bool HasClientObjectData() const | |
95 | { return m_clientDataItemsType == wxClientData_Object; } | |
96 | bool HasClientUntypedData() const | |
97 | { return m_clientDataItemsType == wxClientData_Void; } | |
98 | ||
99 | #if WXWIN_COMPATIBILITY_2_2 | |
100 | // compatibility - these functions are deprecated, use the new ones | |
101 | // instead | |
102 | int Number() const { return GetCount(); } | |
103 | #endif // WXWIN_COMPATIBILITY_2_2 | |
104 | ||
105 | protected: | |
106 | virtual int DoAppend(const wxString& item) = 0; | |
107 | virtual int DoInsert(const wxString& item, int pos) = 0; | |
108 | ||
109 | virtual void DoSetItemClientData(int n, void* clientData) = 0; | |
110 | virtual void* DoGetItemClientData(int n) const = 0; | |
111 | virtual void DoSetItemClientObject(int n, wxClientData* clientData) = 0; | |
112 | virtual wxClientData* DoGetItemClientObject(int n) const = 0; | |
113 | ||
114 | // the type of the client data for the items | |
115 | wxClientDataType m_clientDataItemsType; | |
116 | }; | |
117 | ||
118 | class WXDLLEXPORT wxControlWithItems : public wxControl, public wxItemContainer | |
119 | { | |
120 | public: | |
121 | wxControlWithItems() { } | |
122 | virtual ~wxControlWithItems(); | |
123 | ||
124 | // we have to redefine these functions here to avoid ambiguities in classes | |
125 | // deriving from us which would arise otherwise because both base classses | |
126 | // have the methods with the same names - hopefully, a smart compiler can | |
127 | // optimize away these simple inline wrappers so we don't suffer much from | |
128 | // this | |
129 | ||
130 | void SetClientData(void *data) | |
131 | { | |
132 | wxControl::SetClientData(data); | |
133 | } | |
134 | ||
135 | void *GetClientData() const | |
136 | { | |
137 | return wxControl::GetClientData(); | |
138 | } | |
139 | ||
140 | void SetClientObject(wxClientData *data) | |
141 | { | |
142 | wxControl::SetClientObject(data); | |
143 | } | |
144 | ||
145 | wxClientData *GetClientObject() const | |
146 | { | |
147 | return wxControl::GetClientObject(); | |
148 | } | |
149 | ||
150 | void SetClientData(int n, void* clientData) | |
151 | { | |
152 | wxItemContainer::SetClientData(n, clientData); | |
153 | } | |
154 | ||
155 | void* GetClientData(int n) const | |
156 | { | |
157 | return wxItemContainer::GetClientData(n); | |
158 | } | |
159 | ||
160 | void SetClientObject(int n, wxClientData* clientData) | |
161 | { | |
162 | wxItemContainer::SetClientObject(n, clientData); | |
163 | } | |
164 | ||
165 | wxClientData* GetClientObject(int n) const | |
166 | { | |
167 | return wxItemContainer::GetClientObject(n); | |
168 | } | |
169 | ||
170 | private: | |
171 | DECLARE_NO_COPY_CLASS(wxControlWithItems) | |
172 | }; | |
173 | ||
174 | #endif // wxUSE_CONTROLS | |
175 | ||
176 | #endif // _WX_CTRLSUB_H_BASE_ | |
177 |