DESIGN (xvisual) functions
LIBRARY ROUTINE
xvw_create_panicon - create a panicon object
LIBRARY CALL
xvobject xvw_create_panicon(
xvobject parent,
char *name)
INPUT
- parent - the parent object; NULL will cause a
default toplevel to be created automatically
- name - a name for this particular instance of the panicon
object (for use in app-defaults files, etc)
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.