NAME

IvwGetRegion() − obtain the currently defined region

SYNOPSIS

aBoolean
IvwGetRegion (

Widget w,

Position *x,

Position *y,

int *width,

int *height);

DESCRIPTION

IvwGetRegion() obtains the currently defined region, if one is defined.  It returns a value of FALSE if no region is defined.  Note that the region is relative to the current, visibly displayed area. 

w is the widget that requires the region. 

*x points to the return location for the X coordinate of the upper left corner. 

*y points to the return location for the Y coordinate of the upper left corner. 

*width points to the return location for the width (in pixels) of the region. 

*height points to the return location for the height (in pixels) of the region. 

ERRORS

If an error occurs, any callbacks that are registered with the widget via the IvwNerrorCallback resource are executed.  The error is communicated to the callback routine via the error data structure IvwErrorCallbackStruct.  See IvwErrorCallbackStruct(5). 

AUTHOR

IvwGetRegion() was developed by HP. 

SEE ALSO

IvwCreateDisplay(3X), IvwSetZoomRegion(3X), IvwErrorCallback(5)

Using the Image Developer’s Kit.
 
 

Hewlett-Packard Company  —  Image Library: February, 1995