[Previous] [Contents] [Index] [Next]

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 );

Description:

This function allows you to modify the attributes and window information of a window's region. The Window Manager is notified of this change and will respond accordingly.


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

This function changes the definition of the window region specified by region->rid. The fields argument describes which fields in the region structure are to be used to effect the changes.

The rect argument points to the rectangle associated with the region, and win_info points to the window information that will replace the current win_info on the window region.

The flags argument controls whether or not an expose event will be emitted to this 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.

Returns:

0
Successful completion.
-1
An error occurred.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PhWindowOpen(), PhRegionClose()

See PhWm.h for a description of PhWindowInfo_t.


[Previous] [Contents] [Index] [Next]