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

PhWindowChange()

Modify the attributes of a window's region

Synopsis:

int PhWindowChange( 
            unsigned fields,
            unsigned flags,
            const PhRegion_t *region,
            const PhRect_t *rect,
            const PhWindowInfo_t *win_info );

Arguments:

fields

A bitmap that indicates which members of the PhRegion_t to use to update the window's region. For more information, see PhRegionOpen() in the Photon Library Reference.

flags

Flags that control whether or not an expose event is emitted to the region, when necessary. You can OR the following into flags:

• Ph_EXPOSE_REGION -- if part of the region becomes exposed, send a Ph_EV_EXPOSE event to the region.
• Ph_EXPOSE_FAMILY -- if part of the region becomes exposed, send a Ph_EV_EXPOSE event to the region's descendants.

region

A pointer to a PhRegion_t structure that stores the data to be used to update the window's region.

rect

A pointer to a PhRect_t structure (see the Photon Library Reference) that defines the rectangle associated with the region.

win_info

A pointer to the window information that replaces the current win_info on the window region.

Library:

ph

Description:

This function lets you modify the attributes and window information of a window's region. The Window Manager is notified of this change and responds accordingly.

Don't use this function in an application that uses widgets.

This function changes the definition of the window region specified by region->rid.

Returns:

A nonnegative value

Successful completion.

-1

An error occurred.

Classification:

Photon

See also:

PhWindowOpen()

PhRect_t, PhRegion_t, PhRegionClose(), PhRegionOpen() in the Photon Library Reference

See PhWm.h for a description of PhWindowInfo_t.