kform *xvf_create_form(
char *filename,
int glyph_type,
void (*callback)(kform *, ksubform *, kaddr),
kaddr client_data,
int x,
int y,
int editable)
INPUT
filename - name of the UIS file
glyph_type - type of glyph associated with this form:
KNONE or SIMPLE
callback - optional callback routine for this form
- name of the UIS file
- name of the UIS file
client_data - client data for callback routine
x - X location at which to place the newly created
GUI. If values of x and y are both negative 1,
placement of the GUI must be done manually.
y - Y location at which to place the newly created
GUI. If values of x and y are both negative 1,
placement of the GUI must be done manually.
editable - controls use of the menuforms by the user.
XVF_FULL_EDIT: if GUI is to be completely editable, eg,
as when creating a GUI with preview or guise.
XVF_PARTIAL_EDIT: for normal use where the GUI of the
application is to be editable by the user
in ways that will not affect the performance
of the program (for example, button titles
or location).
XVF_NO_EDIT: will disable use of the menuforms altogether,
so that the user will not be able to change
any aspect of the GUI.
OUTPUT
none
RETURN VALUE
A pointer to the form tree on success, NULL on failure.
DESCRIPTION
This is the main driver for the routines that creates
and maps the forms of an xvroutine, both externally
(the GUI made up of objects) and internally (the abstract
data structure referred to as a form tree).
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$DESIGN/objects/library/xvforms/src/createform.c
SEE ALSO
xvforms(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.