Syntax
[C/C++:]
void ggDisplayValueColumn(float x, float y, int nval, float *values, char header[ ]);
[F90:]
subroutine ggDisplayValueColumn(x, y, nval, values, header)
real, intent(in) :: x, y, values(*)
integer, intent(in) :: nval
character*(*), intent(in) :: header
Arguments
x
X coordinate of the top left hand corner of the column in the current units (default units are millimetres)
y
Y coordinate of the top left hand corner of the column in the current units
nval
The number of values to be output in the column
values
Array of length
nval containing the values to be output
header
Column header
Description
The routine ggDisplayValueColumn() outputs a set of values in an optionally headed column with its top left corner positioned at
x,
y in user space coordinates. The column is divided into
nval or
nval+1 cells (depending on the header switch) into which the values are placed according to the current Text Chart justification as set by ggSetTextChartAttribs(). A column frame is also drawn using the Text Chart frame colour index also set by ggSetTextChartAttribs().
The values are held in the array
values and are output, using the current GINO text and line attributes, in the format of the current Y axis annotation as set by ggSetAxesAnnotation(). Prefix and/or suffix strings may be added to each value in the column using the routine ggSetValueTags().
The string
header is output in an additional header cell if headers are switched on in the previous call to ggSetTextChartAttribs(). If displayed, the string is output centrally in the cell using the current GINO text and line attributes.
See Also
ggDisplayValueColumn UsageggSetAxesAnnotationggSetTextChartAttribsggSetValueTags
