DESIGN (xvforms) functions


LIBRARY ROUTINE

xvf_get_kformstruct - return kformstruct associated w/ xvobject

LIBRARY CALL

kform_struct *xvf_get_kformstruct(
    kform    *form,
    xvobject object)

INPUT

OUTPUT

none

RETURN VALUE

A pointer to the kformstruct on success, NULL on failure.

DESCRIPTION

Written for cantata, this routine takes an xvobject and a form tree, and searches through the form tree for the master, subform, guidepane, pane, or selection to which the xvobject belongs (for example, the xvobject might be the label of a cycle selection, the text parameter box of an input file selection, the title on a master form, etc). If the xvobject is found in the form tree, the kformstruct corresponding to the GUI item on which it is found is returned.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DESIGN/objects/library/xvforms/src/get.c

SEE ALSO

xvforms(3)

COPYRIGHT

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