DESIGN (xvisual) functions


LIBRARY ROUTINE

xvw_create_date - create a date object.

LIBRARY CALL

xvobject xvw_create_date(
   xvobject parent,
   char     *name)

INPUT

OUTPUT

none

RETURN VALUE

The date object on success, NULL on failure

DESCRIPTION

A date visual object displays the current date according to the internal clock of your computer.

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

Alternatively, the location of the date may be specified using device coordinates. As when world coordinates are used, specify the (x,y) location of the upper left hand corner of the text that will display the date.

The amount of space used by the text displaying the date 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 displaying the date; 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 date object also supports multiple styles in which the string displaying the date 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/Date.c

SEE ALSO

xvisual(3)

COPYRIGHT

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