Manipulating External Object Data
Functions Introduced:
• ProExtobjdataAdd()
• ProExtobjdataSet()
• ProExtobjdataGet()
• ProExtobjdataRemove()
• ProExtobjdataFree()
The previous two sections describe how to create and modify external object data. In the case of both display and selection data, the data creation process results in the opaque workspace handle ProWExtobjdata. The functions in this section enable you to manipulate how the external object data relates to the object itself.
To add new data to an external object, pass the data handle ProWExtobjdata to the function ProExtobjdataAdd(). To set the contents of existing object data, call the function ProExtobjdataSet().
The function ProExtobjdataGet() obtains the handle for the display or selection data associated with an external object. To specify which type of data you want to retrieve, pass to this function one of the values in the enumerated type ProExtobjdataType. The declaration is as follows:
typedef enum
{
PRO_EXTOBJDAT_DISPLAY,
PRO_EXTOBJDAT_SELBOX
} ProExtobjdataType;
To remove data from an external object, use the function ProExtobjdataRemove(). To free the memory occupied by external object data, call the function ProExtobjdataFree().