This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

PtAddWidgetData()

Add data to the widget data chain

Synopsis:

int PtAddWidgetData( PtWidget_t *widget, 
                     PtWidgetClassRef_t *type, 
                     long subtype, 
                     void *data );

Arguments:

widget: A pointer to the widget whose chain the data should be added to.
type: The class of the widget adding the data.
subtype: A subtype that's used to discriminate between multiple blocks of data added by the same widget class. The subtype shouldn't be -1, as this value has special meaning when searching for a specific block within the widget data chain.
data: A pointer to the data to be added to the widget data chain.

Description:

This function adds a piece of data to the widget data chain. The data provided must be in a block of memory allocated by malloc() (see the QNX Neutrino Library Reference).

You can retrieve this data by calling PtFindWidgetData() or PtFindNextWidgetData().

Returns:

0 on success; -1 if an error occurred (e.g. out of memory).

Classification:

Photon