wxclientdataall classes deriving from wxevthandler (such as all controls and wxapp) can hold arbitrary data which is here referred to as "client data". this is useful e.g. for scripting languages which need to handle shadow objects for most of wxwidgets' classes and which store a handle to such a shadow class as client data in that class. this data can either be of type void - in which case the data container does not take care of freeing the data again or it is of type wxclientdata or its derivatives. in that case the container (e.g. a control) will free the memory itself later. note that you must not assign both void data and data derived from the wxclientdata class to a container. some controls can hold various items and these controls can additionally hold client data for each item. this is the case for wxchoice, wxcombobox and wxlistbox. wxtreectrl has a specialized class wxtreeitemdata for each item in the tree. if you want to add client data to your own classes, you may use the mix-in class wxclientdatacontainer. include files <wx/clntdata.h> see also wxevthandler, wxtreeitemdata, wxstringclientdata, wxclientdatacontainer members
wxclientdata::wxclientdata
wxclientdata::wxclientdatawxclientdata() constructor.
wxclientdata::~wxclientdata~wxclientdata() virtual destructor.
|