DESIGN (xvlang) functions
LIBRARY ROUTINE
xvw_create_port - create a port object
LIBRARY CALL
xvobject xvw_create_port(
xvobject parent,
char *name)
INPUT
- parent - the parent object; NULL will cause a
default toplevel to be created automatically
- name - the name with which to reference the object
OUTPUT
none
RETURN VALUE
The port object on success, NULL on failure
DESCRIPTION
The purpose of the Port object is to provide a general
mechanism for representing a "port" within a visual program.
Typically these are used by the glyph to represent input
and output connections within the visual program. Normally
the port is created by other visual programming components,
such as the Node object, but is provided so that other
styles of visual programs can be created.
The Port object is really available to reduce the complexity
of the application programmer in dealing with the user
interactions of connecting Glyphs together. It also
manages the complexity of representing the connections
and the UIS that is used to represent the Port. So
if the user updates the filename represented by the
Port, and the Port is an output, then the contains
of the Ports connected to the output, are updated
appropriately.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$DESIGN/objects/library/xvlang/src/Port.c
SEE ALSO
xvlang(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.