DataAttach()

NAME

DataAttach - Attach a data to a window.

PROTOTYPAGE

int DataAttach( WINDOW *win, long magic, void *data);

PARAMETERS

win:

targetted window,

magic:

magic number,

data:

address of data to attach,

return:

0 si no error or a negativ error code

DESCRIPTION

DataAttach() attaches an user data to a window. There are no limit (except the memory) to the numberof data. Data are stored in a list whose the window keeps the root item. Each item in the list, so each data, is identified by a magic number (as cookies in the system cookiejar). Some magic number are reserved by WinDom (because some predefined windows, such as form, use data). See WinDom header file (they have a WD_ prefix).

SEE ALSO

DataSearch(), DataDelete().