[Previous] [Contents] [Index] [Next]

PtFindNextWidgetData()

Find the next appropriate data block

Synopsis:

void * PtFindNextWidgetData( 
           PtWidget_t *widget, 
           PtDataHdr_t *data_node, 
           PtWidgetClassRef_t *type, 
           long subtype, 
           PtDataHdr_t **_node )

Description:

This function (starting from data_node) finds the next widget data block that matches the type and subtype provided. If data_node is NULL, the first instance of data that matches the type and subtype provided will be found. If type is NULL, any type will match. If subtype is -1, any subtype will match.

If _node is provided, it's set to point to the widget data_node that contained the returned data, so you can continue the search from that node.

Returns:

A void pointer to the widget data, or NULL if it wasn't found.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PtAddWidgetData(), PtFindWidgetData(), PtRemoveWidgetData()


[Previous] [Contents] [Index] [Next]