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