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

PtCalcRegion()

Determine whether or not a widget needs a region

Synopsis:

int PtCalcRegion( unsigned int *fields,
                  PtWidget_t *widget,
                  PhRegion_t *region,
                  PhRect_t *rect );

Arguments:

fields: A bitmap that specifies which fields of the PhRegion_t structure pointed to by region the function should fill in. For more information, see PhRegionOpen() in the Photon Library Reference.
widget: A pointer to the widget you want to test.
region: A pointer to a PhRegion_t structure in which the function stores information about the region.
rect: A pointer to a PhRect_t structure that defines the rectangle for the region.

Description:

This function determines whether or not the given widget needs a region and stores information about the region in the PhRegion_t structure pointed to by region.

Returns:

0: The widget doesn't need a region.
1: The widget needs a region.

Classification:

Photon