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

PtCoreChangeRegion()

Determine if a region is required

Synopsis:

void PtCoreChangeRegion( unsigned int fields,
                         PtWidget_t *widget );

Arguments:

fields
A bitmap that indicates which attributes of the widget to check. For more information, see PhRegionOpen() in the Photon Library Reference.
widget
A pointer to the widget to be tested.

Description:

This function examines the current state of widget with respect to fields and determines if widget requires a region. If a region is required, PtCoreChangeRegion() determines what attributes (e.g. sensitivity) are required.

PtCoreChangeRegion() may call one of the following functions with appropriate attributes:

If the widget: This function is called:
Is a subclass of PtWindow PhWindowChange()
Already has a region PhRegionChange()
Doesn't have a region PhRegionOpen()

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PhWindowChange(), PhRegionChange(), PhRegionOpen() in the Photon Library Reference