]> git.saurik.com Git - wxWidgets.git/blame - include/wx/clntdata.h
finally really fixes IRIX build:
[wxWidgets.git] / include / wx / clntdata.h
CommitLineData
88a9f974
RD
1/////////////////////////////////////////////////////////////////////////////
2// Name: wx/clntdata.h
3// Purpose: A mixin class for holding a wxClientData or void pointer
4// Author: Robin Dunn
5// Modified by:
6// Created: 9-Oct-2001
7// RCS-ID: $Id$
77ffb593 8// Copyright: (c) wxWidgets team
65571936 9// Licence: wxWindows licence
88a9f974
RD
10/////////////////////////////////////////////////////////////////////////////
11
12#ifndef _WX_CLNTDATAH__
13#define _WX_CLNTDATAH__
14
12028905 15#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
16d38102 16 #pragma interface "clntdata.h"
88a9f974
RD
17#endif
18
19#include "wx/defs.h"
16d38102 20#include "wx/string.h"
619f45aa
RR
21#include "wx/hashmap.h"
22
6900d12d
MW
23#if wxABI_VERSION >= 20602
24
619f45aa 25typedef int (*wxShadowObjectMethod)(void*, void*);
0a64bfdf
VZ
26WX_DECLARE_STRING_HASH_MAP_WITH_DECL(
27 wxShadowObjectMethod,
28 wxShadowObjectMethods,
29 class WXDLLIMPEXP_BASE
30);
31WX_DECLARE_STRING_HASH_MAP_WITH_DECL(
32 void *,
33 wxShadowObjectFields,
34 class WXDLLIMPEXP_BASE
35);
619f45aa
RR
36
37class WXDLLIMPEXP_BASE wxShadowObject
38{
39public:
40 wxShadowObject() { }
41
42 void AddMethod( const wxString &name, wxShadowObjectMethod method )
43 {
44 wxShadowObjectMethods::iterator it = m_methods.find( name );
45 if (it == m_methods.end())
46 m_methods[ name ] = method;
47 else
48 it->second = method;
49 }
50
51 bool InvokeMethod( const wxString &name, void* window, void* param, int* returnValue )
52 {
53 wxShadowObjectMethods::iterator it = m_methods.find( name );
54 if (it == m_methods.end())
55 return false;
56 wxShadowObjectMethod method = it->second;
57 int ret = (*method)(window, param);
58 if (returnValue)
59 *returnValue = ret;
60 return true;
61 }
62
63 void AddField( const wxString &name, void* initialValue = NULL )
64 {
65 wxShadowObjectFields::iterator it = m_fields.find( name );
66 if (it == m_fields.end())
67 m_fields[ name ] = initialValue;
68 else
69 it->second = initialValue;
70 }
71
72 void SetField( const wxString &name, void* value )
73 {
74 wxShadowObjectFields::iterator it = m_fields.find( name );
75 if (it == m_fields.end())
76 return;
77 it->second = value;
78 }
79
80 void* GetField( const wxString &name, void *defaultValue = NULL )
81 {
82 wxShadowObjectFields::iterator it = m_fields.find( name );
83 if (it == m_fields.end())
84 return defaultValue;
85 return it->second;
86 }
87
88private:
89 wxShadowObjectMethods m_methods;
90 wxShadowObjectFields m_fields;
91};
88a9f974 92
6900d12d
MW
93#endif // wxABI_VERSION
94
88a9f974
RD
95// ----------------------------------------------------------------------------
96
97// what kind of client data do we have?
98enum wxClientDataType
99{
100 wxClientData_None, // we don't know yet because we don't have it at all
101 wxClientData_Object, // our client data is typed and we own it
102 wxClientData_Void // client data is untyped and we don't own it
103};
104
6b91e252 105class WXDLLIMPEXP_BASE wxClientData
88a9f974
RD
106{
107public:
108 wxClientData() { }
109 virtual ~wxClientData() { }
110};
111
6b91e252 112class WXDLLIMPEXP_BASE wxStringClientData : public wxClientData
88a9f974
RD
113{
114public:
d84afea9 115 wxStringClientData() : m_data() { }
88a9f974
RD
116 wxStringClientData( const wxString &data ) : m_data(data) { }
117 void SetData( const wxString &data ) { m_data = data; }
118 const wxString& GetData() const { return m_data; }
119
120private:
121 wxString m_data;
122};
123
16d38102
RD
124// This class is a mixin that provides storage and management of "client
125// data." The client data stored can either be a pointer to a wxClientData
ae500232 126// object in which case it is managed by the container (i.e. it will delete
16d38102 127// the data when it's destroyed) or an untyped pointer which won't be deleted
2aab8f16
RD
128// by the container - but not both of them
129//
130// NOTE: This functionality is currently duplicated in wxEvtHandler in order
ae500232 131// to avoid having more than one vtable in that class hierarchy.
16d38102 132
6b91e252 133class WXDLLIMPEXP_BASE wxClientDataContainer
88a9f974
RD
134{
135public:
136 wxClientDataContainer();
16d38102 137 virtual ~wxClientDataContainer();
88a9f974 138
88a9f974
RD
139 void SetClientObject( wxClientData *data ) { DoSetClientObject(data); }
140 wxClientData *GetClientObject() const { return DoGetClientObject(); }
141
142 void SetClientData( void *data ) { DoSetClientData(data); }
143 void *GetClientData() const { return DoGetClientData(); }
144
145protected:
16d38102 146 // The user data: either an object which will be deleted by the container
ae500232
JS
147 // when it's deleted or some raw pointer which we do nothing with. Only
148 // one type of data can be used with the given window, i.e. you cannot set
b88c44e7 149 // the void data and then associate the container with wxClientData or vice
ae500232 150 // versa.
88a9f974
RD
151 union
152 {
153 wxClientData *m_clientObject;
154 void *m_clientData;
155 };
156
157 // client data accessors
158 virtual void DoSetClientObject( wxClientData *data );
159 virtual wxClientData *DoGetClientObject() const;
160
161 virtual void DoSetClientData( void *data );
162 virtual void *DoGetClientData() const;
163
164 // what kind of data do we have?
165 wxClientDataType m_clientDataType;
166
167};
2aab8f16 168
6603071a
MB
169// not Motif-specific, but currently used only under Motif,
170// compiled to make wxMotif and wxGTK base libraries compatible
171#if defined(__WXMOTIF__) || wxABI_VERSION >= 20602
21b27373 172
59afc60f 173#include "wx/vector.h"
21b27373 174
6b91e252 175struct WXDLLIMPEXP_BASE wxClientDataDictionaryPair
21b27373
MB
176{
177 wxClientDataDictionaryPair( size_t idx ) : index( idx ), data( 0 ) { }
178
179 size_t index;
180 wxClientData* data;
181};
182
442a79c0
VZ
183_WX_DECLARE_VECTOR(
184 wxClientDataDictionaryPair,
185 wxClientDataDictionaryPairVector,
186 WXDLLIMPEXP_BASE
187);
21b27373
MB
188
189// this class is used internally to maintain the association between items
190// of (some subclasses of) wxControlWithItems and their client data
ae500232
JS
191// NOTE: this class does not keep track of whether it contains
192// wxClientData or void*. The client must ensure that
21b27373
MB
193// it does not contain a mix of the two, and that
194// DestroyData is called if it contains wxClientData
6b91e252 195class WXDLLIMPEXP_BASE wxClientDataDictionary
21b27373
MB
196{
197public:
6fb99eb3 198 wxClientDataDictionary() {}
21b27373
MB
199
200 // deletes all the data
201 void DestroyData()
202 {
203 for( size_t i = 0, end = m_vec.size(); i != end; ++i )
204 delete m_vec[i].data;
205 m_vec.clear();
206 }
207
208 // if data for the given index is not present, add it,
209 // if it is present, delete the old data and replace it with
210 // the new one
211 void Set( size_t index, wxClientData* data, bool doDelete )
212 {
213 size_t ptr = Find( index );
214
215 if( !data )
216 {
217 if( ptr == m_vec.size() ) return;
218 if( doDelete )
219 delete m_vec[ptr].data;
220 m_vec.erase( ptr );
221 }
222 else
223 {
224 if( ptr == m_vec.size() )
225 {
226 m_vec.push_back( wxClientDataDictionaryPair( index ) );
227 ptr = m_vec.size() - 1;
228 }
229
230 if( doDelete )
231 delete m_vec[ptr].data;
232 m_vec[ptr].data = data;
233 }
234 }
235
236 // get the data associated with the given index,
237 // return 0 if not found
238 wxClientData* Get( size_t index ) const
239 {
240 size_t it = Find( index );
241 if( it == m_vec.size() ) return 0;
242 return (wxClientData*)m_vec[it].data; // const cast
243 }
244
245 // delete the data associated with the given index
246 // it also decreases by one the indices of all the elements
247 // with an index greater than the given index
248 void Delete( size_t index, bool doDelete )
249 {
250 size_t todel = m_vec.size();
251
252 for( size_t i = 0, end = m_vec.size(); i != end; ++i )
253 {
254 if( m_vec[i].index == index )
255 todel = i;
256 else if( m_vec[i].index > index )
257 --(m_vec[i].index);
258 }
259
260 if( todel != m_vec.size() )
261 {
262 if( doDelete )
263 delete m_vec[todel].data;
264 m_vec.erase( todel );
265 }
266 }
267private:
268 // returns MyVec.size() if not found
269 size_t Find( size_t index ) const
270 {
271 for( size_t i = 0, end = m_vec.size(); i != end; ++i )
272 {
273 if( m_vec[i].index == index )
274 return i;
275 }
276
277 return m_vec.size();
278 }
279
280 wxClientDataDictionaryPairVector m_vec;
281};
282
283#endif // __WXMOTIF__
284
88a9f974
RD
285// ----------------------------------------------------------------------------
286#endif
287