NAME¶
cdk_histogram - curses histogram widget
SYNOPSIS¶
cc [
flag ... ]
file ...
-lcdk [
library ...
]
#include <cdk.h>
- void activateCDKHistogram (
-
CDKHISTOGRAM *histogram,
chtype unused);
- void destroyCDKHistogram (
-
CDKHISTOGRAM *histogram);
- void drawCDKHistogram (
-
CDKHISTOGRAM *histogram,
boolean box);
- void eraseCDKHistogram (
-
CDKHISTOGRAM *histogram);
- boolean getCDKHistogramBox (
-
CDKHISTOGRAM *histogram);
- chtype getCDKHistogramFillerChar (
-
CDKHISTOGRAM *histogram);
- int getCDKHistogramHighValue (
-
CDKHISTOGRAM *histogram);
- int getCDKHistogramLowValue (
-
CDKHISTOGRAM *histogram);
- chtype getCDKHistogramStatsAttr (
-
CDKHISTOGRAM *histogram);
- int getCDKHistogramStatsPos (
-
CDKHISTOGRAM *histogram);
- int getCDKHistogramValue (
-
CDKHISTOGRAM *histogram);
- EHistogramDisplayType getCDKHistogramViewType (
-
CDKHISTOGRAM *histogram);
- void moveCDKHistogram (
-
CDKHISTOGRAM *histogram,
int xpos,
int ypos,
boolean relative,
boolean refresh);
- CDKHISTOGRAM *newCDKHistogram (
-
CDKSCREEN *cdkscreen,
int xpos,
int ypos,
int height,
int width,
int orient,
char *title,
boolean box,
boolean shadow);
- void positionCDKHistogram (
-
CDKHISTOGRAM *histogram);
- void setCDKHistogram (
-
CDKHISTOGRAM *histogram,
EHistogramDisplayType viewType,
int statsPos,
chtype statsAttribute,
int lowValue,
int highValue,
int currentValue,
chtype fillerCharacter,
boolean box);
- void setCDKHistogramBackgroundAttrib (
-
CDKHISTOGRAM *histogram,
chtype attribute);
- void setCDKHistogramBackgroundColor (
-
CDKHISTOGRAM *histogram,
char * color);
- void setCDKHistogramBox (
-
CDKHISTOGRAM *histogram,
boolean box);
- void setCDKHistogramBoxAttribute (
-
CDKHISTOGRAM *histogram,
chtype character);
- void setCDKHistogramDisplayType (
-
CDKHISTOGRAM *histogram,
EHistogramDisplayType viewtype);
- void setCDKHistogramFillerChar (
-
CDKHISTOGRAM *histogram,
chtype fillerCharacter);
- void setCDKHistogramHorizontalChar (
-
CDKHISTOGRAM *histogram,
chtype character);
- void setCDKHistogramLLChar (
-
CDKHISTOGRAM *histogram,
chtype character);
- void setCDKHistogramLRChar (
-
CDKHISTOGRAM *histogram,
chtype character);
- void setCDKHistogramStatsAttr (
-
CDKHISTOGRAM *histogram,
chtype statsAttribute);
- void setCDKHistogramStatsPos (
-
CDKHISTOGRAM *histogram,
int statsPosition);
- void setCDKHistogramULChar (
-
CDKHISTOGRAM *histogram,
chtype character);
- void setCDKHistogramURChar (
-
CDKHISTOGRAM *histogram,
chtype character);
- void setCDKHistogramValue (
-
CDKHISTOGRAM *histogram,
int lowValue,
int highValue,
int currentValue);
- void setCDKHistogramVerticalChar (
-
CDKHISTOGRAM *histogram,
chtype character);
- void setCDKHistogramViewType (
-
CDKHISTOGRAM *histogram,
EHistogramDisplayType viewType);
DESCRIPTION¶
The Cdk histogram widget creates a histogram widget. This widget can draw a
vertical or horizontal histogram. The functions create or manipulate the Cdk
histogram box widget.
AVAILABLE FUNCTIONS¶
- activateCDKHistogram
- obsolete entrypoint which calls
drawCDKHistogram.
- destroyCDKHistogram
- removes the widget from the screen and frees memory the
object used.
- drawCDKHistogram
- draws the histogram widget on the screen. If the box
parameter is true, the widget is drawn with a box.
- eraseCDKHistogram
- removes the widget from the screen. This does NOT
destroy the widget.
- getCDKHistogramBox
- returns true if the widget will be drawn with a box around
it.
- getCDKHistogramFillerChar
- returns the character being used to draw the histogram
bar.
- getCDKHistogramHighValue
- returns the high value of the histogram.
- getCDKHistogramLowValue
- returns the low value of the histogram.
- getCDKHistogramStatsAttr
- returns the attribute of the statistics of the
histogram.
- getCDKHistogramStatsPos
- returns where the histogram will draw the statistics.
- getCDKHistogramValue
- returns the current value of the histogram.
- getCDKHistogramViewType
- returns the view type of the histogram widget.
- moveCDKHistogram
- moves the given widget to the given position. The
parameters xpos and ypos are the new position of the widget.
The parameter xpos may be an integer or one of the pre-defined
values TOP, BOTTOM, and CENTER. The parameter
ypos can be an integer or one of the pre-defined values
LEFT, RIGHT, and CENTER. The parameter
relative states whether the xpos/ypos pair is a
relative move or an absolute move. For example if xpos = 1 and
ypos = 2 and relative = TRUE, then the widget would
move one row down and two columns right. If the value of relative
was FALSE then the widget would move to the position (1,2). Do not
use the values TOP, BOTTOM, LEFT, RIGHT, or
CENTER when relative = TRUE. (weird things may
happen). The final parameter refresh is a boolean value which
states whether the widget will get refreshed after the move.
- newCDKHistogram
- creates a histogram widget and returns a pointer to it.
Parameters:
- screen
- is the screen you wish this widget to be placed in.
- xpos
- controls the placement of the object along the horizontal
axis. It may be an integer or one of the pre-defined values LEFT,
RIGHT, and CENTER.
- ypos
- controls the placement of the object along the vertical
axis. It may be an integer or one of the pre-defined values TOP,
BOTTOM, and CENTER.
- title
- is the string which will be displayed at the top of the
widget. The title can be more than one line; just provide a carriage
return character at the line break.
- height and
- width
- control the height and width of the widget. If you provide
a value of zero for either of the height or the width, the widget will be
created with the full width and height of the screen. If you provide a
negative value, the widget will be created the full height or width minus
the value provided.
- orient
- specifies the orientation of the histogram. It is one of
these pre-defined values: VERTICAL and HORIZONTAL.
- label
- is the string to use as the label of the histogram.
- box
- is true if the widget should be drawn with a box around
it.
- shadow
- turns the shadow on or off around this widget.
- If the widget could not be created then a NULL
pointer is returned.
- positionCDKHistogram
- allows the user to move the widget around the screen via
the cursor/keypad keys. See cdk_position (3) for key bindings.
- setCDKHistogram
- lets the programmer set the specific values of the
histogram widget. The parameter viewType specifies the type of
histogram to draw. The following table lists the valid values and the
results.
Display_Type |
Result |
vNONE |
Displays no information about the current values. |
vPERCENT |
Displays the current value as a percentage. |
vFRACTION |
Displays the current value as a fraction. |
vREAL |
Displays the current value. |
- The statsPosition parameter states where the
statistics will be displayed. It accepts TOP, BOTTOM, and
CENTER.
- The parameter statsAttribute sets the attributes of
the statistics.
- The parameters lowValue, highValue, and
currentValue are the low, high, and current values
respectively.
- The filler character is the character to use in the
unused space in the histogram.
- If the box parameter is true, the widget is drawn
with a box.
- setCDKHistogramBackgroundAttrib
- the background color attribute the widget. The parameter
attribute is a curses attribute, e.g., A_BOLD.
- setCDKHistogramBackgroundColor
- the background color of the widget. The parameter
color is in the format of the Cdk format strings. See
cdk_display (3).
- setCDKHistogramBox
- sets whether the widget will be drawn with a box around
it.
- setCDKHistogramBoxAttribute
- sets the attribute of the box.
- setCDKHistogramDisplayType
- sets the display type (see
getCDKHistogramViewType).
- setCDKHistogramFillerChar
- sets the character to use when drawing the histogram
bar.
- setCDKHistogramHorizontalChar
- sets the horizontal drawing character for the box to the
given character.
- setCDKHistogramLLChar
- sets the lower left hand corner of the widget's box to the
given character.
- setCDKHistogramLRChar
- sets the lower right hand corner of the widget's box to the
given character.
- setCDKHistogramStatsAttr
- sets the attribute to use when drawing the histogram
statistics.
- setCDKHistogramStatsPos
- sets where the statistics will be drawn on the widget. See
the setCDKHistogram description for more details.
- setCDKHistogramULChar
- sets the upper left hand corner of the widget's box to the
given character.
- setCDKHistogramURChar
- sets the upper right hand corner of the widget's box to the
given character.
- setCDKHistogramValue
- sets the low, high, and current value of the
histogram.
- setCDKHistogramVerticalChar
- sets the vertical drawing character for the box to the
given character.
- setCDKHistogramViewType
- sets the view type of the histogram. Look at the
setCDKHistogram description for more details.
SEE ALSO¶
cdk(3),
cdk_binding(3),
cdk_display(3),
cdk_position(3),
cdk_screen(3)