DESIGN (xvisual) functions


LIBRARY ROUTINE

xvw_create_stringvalue - creates a string value object

LIBRARY CALL

xvobject xvw_create_stringvalue(
   xvobject parent,
   char     *name)

INPUT

OUTPUT

none

RETURN VALUE

The stringvalue object on success, NULL on failure

DESCRIPTION

A stringvalue object supports the display of a formatted number. Thus, standard C formatting strings such as "%g" or "%.3f" may be used to neatly display a floating point or double precision value.

The location of the upper left corner of the the stringvalue may be specified in world coordinates, where the world coordinate range is dictated by the "controlling" visual object. By default, the parent of the stringvalue object is its controlling visual object; this may be changed using the XVW_GRAPHICS_ATTACH attribute.

Alternatively, the location of the stringvalue may be specified using device coordinates. As when using world coordinates, specify the upper left hand corner of the stringvalue.

The amount of space used by the stringvalue cannot be explicitly set by the application; this is automatically calculated according to the font that is used. Specification of a width and height simply provides a buffer of space around the text; note that justification will have no effect unless the width and height are specified to be larger than what is actually needed by the text displaying the date. Width and height may be specified in characters or in pixels.

In addition to font specification, the stringvalue object also supports multiple styles in which the specified number can appear: available styles include plain, emphasized, embossed in, and embossed out.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

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

SEE ALSO

xvisual(3)

COPYRIGHT

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