DESIGN (xvisual) functions


LIBRARY ROUTINE

xvw_create_panicon - create a panicon object

LIBRARY CALL

xvobject xvw_create_panicon(
   xvobject parent,
   char     *name)

INPUT

OUTPUT

none

RETURN VALUE

Returns the panicon object, or NULL upon failure

DESCRIPTION

A panicon object provides a mechanism with which to roam around in an image which is too large to be accomodated by the image object in which it is displayed. Thus, the panicon object must be used in conjunction with an image object on which it will pan.

Note that the XVW_IMAGE_IMAGEOBJ attribute is used to specify the data object on which the panicon should pan; this should be the same data object as the one displayed in the image object.

The panicon object will not be mapped unless it is needed; a created panicon object will remain "invisible" if the image being displayed is small enough to fit within the image object. Thus, if an application using an image object expects to ever receive a request to display an image which is larger than the image object size, a pan icon object should always be created; it will not appear unless it is necessary.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DESIGN/objects/library/xvisual/src/PanIcon.c

SEE ALSO

xvisual(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.