PtRelease()

Decrement the global widget hold count

Synopsis:

int PtRelease( void );

Description:

This function decrements the global widget hold count, which was previously incremented by a call to PtHold(). When the count reaches 0, the widgets are repaired.

A global hold count of 0 simply means that the application doesn't want to prevent widgets from repairing themselves. The widgets manage their own damage repair and may not take immediate action even if the global hold count is 0.

Each damaged widget that has been held by PtHold() and then released by PtRelease() is repaired separately.

PtHold() and PtRelease() affect all widgets while PtContainerHold() and PtContainerRelease() prevent only child widgets of a container from being repaired.

Returns:

The new value of the global hold count.

Classification:

Photon

See also:

PtContainerHold(), PtContainerRelease(), PtFlush(), PtHold()