194 lines
5.1 KiB
Groff
194 lines
5.1 KiB
Groff
|
'\" t
|
||
|
|
.\" $Id: cdk.3,v 1.14 2012/03/23 11:39:19 tom Exp $
|
||
|
|
.de It
|
||
|
|
.br
|
||
|
|
.ie \\n(.$>=3 .ne \\$3
|
||
|
|
.el .ne 3
|
||
|
|
.IP "\\$1" \\$2
|
||
|
|
..
|
||
|
|
.TH Cdk 3
|
||
|
|
.SH NAME
|
||
|
|
cdk - \fBCurses Development Kit\fR
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.LP
|
||
|
|
.B cc
|
||
|
|
.RI "[ " "flag" " \|.\|.\|. ] " "file" " \|.\|.\|."
|
||
|
|
.B \-lcdk
|
||
|
|
.RI "[ " "library" " \|.\|.\|. ]"
|
||
|
|
.LP
|
||
|
|
#include <cdk.h>
|
||
|
|
.LP
|
||
|
|
Cdk provides functions to use a large number of predefined curses widgets.
|
||
|
|
To use the Cdk widgets the header file \fIcdk.h\fR must be included in the source.
|
||
|
|
.LP
|
||
|
|
The widgets available from Cdk are listed below.
|
||
|
|
.LP
|
||
|
|
.TS
|
||
|
|
center tab(/);
|
||
|
|
l l
|
||
|
|
l l .
|
||
|
|
\fBWidget Type/Manual Page Name\fR
|
||
|
|
=
|
||
|
|
Alphalist/cdk_alphalist (3)
|
||
|
|
Button/cdk_button (3)
|
||
|
|
Buttonbox/cdk_buttonbox (3)
|
||
|
|
Calendar/cdk_calendar (3)
|
||
|
|
Dialog/cdk_dialog (3)
|
||
|
|
DoubleFloat Scale/cdk_dscale (3)
|
||
|
|
Entry Field/cdk_entry (3)
|
||
|
|
File Selector/cdk_fselect (3)
|
||
|
|
File Viewer/cdk_viewer (3)
|
||
|
|
Floating Scale/cdk_fscale (3)
|
||
|
|
Floating Slider/cdk_fslider (3)
|
||
|
|
Graph/cdk_graph (3)
|
||
|
|
Histogram/cdk_histogram (3)
|
||
|
|
Integer Scale/cdk_scale (3)
|
||
|
|
Integer Slider/cdk_slider (3)
|
||
|
|
Item List/cdk_itemlist (3)
|
||
|
|
Label/cdk_label (3)
|
||
|
|
Marquee/cdk_marquee (3)
|
||
|
|
Matrix/cdk_matrix (3)
|
||
|
|
Multiple Line Entry Field/cdk_mentry (3)
|
||
|
|
Pulldown Menu/cdk_menu (3)
|
||
|
|
Radio List/cdk_radio (3)
|
||
|
|
Scrolling List/cdk_scroll (3)
|
||
|
|
Scrolling Selection List/cdk_selection (3)
|
||
|
|
Scrolling Window/cdk_swindow (3)
|
||
|
|
Template/cdk_template (3)
|
||
|
|
Unsigned Scale/cdk_uscale (3)
|
||
|
|
Unsigned Slider/cdk_uslider (3)
|
||
|
|
.TE
|
||
|
|
.LP
|
||
|
|
The rest of the manual pages describe supporting functions:
|
||
|
|
.LP
|
||
|
|
.TS
|
||
|
|
center tab(/);
|
||
|
|
l l
|
||
|
|
l l
|
||
|
|
lw18 lw35 .
|
||
|
|
\fBManual Page Name/Description\fR
|
||
|
|
=
|
||
|
|
cdk_binding (3)/T{
|
||
|
|
Outlines how to create user definable key bindings.
|
||
|
|
T}
|
||
|
|
cdk_display (3)/T{
|
||
|
|
Shows how to add special display attributes,
|
||
|
|
colors, and justification into a widget.
|
||
|
|
T}
|
||
|
|
cdk_draw (3)/T{
|
||
|
|
Outlines functions used for drawing text and lines.
|
||
|
|
T}
|
||
|
|
cdk_screen (3)/T{
|
||
|
|
Demonstrates the use of screens within Cdk.
|
||
|
|
T}
|
||
|
|
cdk_misc (3)/T{
|
||
|
|
Outlines miscellaneous functions provided with the Cdk library.
|
||
|
|
T}
|
||
|
|
cdk_process (3)/T{
|
||
|
|
Demonstrates the use of the pre- and post-process function class.
|
||
|
|
T}
|
||
|
|
.TE
|
||
|
|
.SH DESCRIPTION
|
||
|
|
Cdk is a library of functions which allow a programmer to quickly create a
|
||
|
|
full screen interactive program with ease.
|
||
|
|
The Cdk widgets support the
|
||
|
|
following features:
|
||
|
|
.It "\(bu Ncurses library." 5
|
||
|
|
Instead of using the standard curses library, Cdk can take advantage of the
|
||
|
|
colors that Ncurses provides.
|
||
|
|
To learn how to take advantage of Cdk's color
|
||
|
|
capabilities, see \fIcdk_display (3)\fR.
|
||
|
|
.PP
|
||
|
|
.It "\(bu Key Bindings." 5
|
||
|
|
Individual keys can be overridden with a callback.
|
||
|
|
The callback is set up using
|
||
|
|
the \fBbindCDKObject\fR function.
|
||
|
|
To learn more about this see \fIcdk_binding (3)\fR.
|
||
|
|
.PP
|
||
|
|
.It "\(bu Pre and Post Processing." 5
|
||
|
|
Certain widgets allow the user to trap a character before and after the
|
||
|
|
character has been applied to the widget.
|
||
|
|
This allows programmers to `filter' character input.
|
||
|
|
To learn more about this see \fIcdk_process (3)\fR.
|
||
|
|
.PP
|
||
|
|
.It "\(bu Self Test Widgets." 5
|
||
|
|
With the use of the inject function class and the activate function,
|
||
|
|
programmers can have the widgets test themselves.
|
||
|
|
This allows the programmer
|
||
|
|
to perform automated tests on a final program.
|
||
|
|
.PP
|
||
|
|
.It "\(bu Special Display Formats" 5
|
||
|
|
There are special character format commands that can be inserted into any
|
||
|
|
string in Cdk and the contents will get mapped to a \fIchtype\fR (see the
|
||
|
|
curses manual page) with character attributes.
|
||
|
|
This allows the programmer to
|
||
|
|
insert format types on each character if they wish.
|
||
|
|
.PP
|
||
|
|
.It "\(bu The Ability To Build Predefined Screens" 5
|
||
|
|
Widgets can be associated to any given screen.
|
||
|
|
If there is more than one
|
||
|
|
screen defined, then Cdk has the ability to "flip" from one screen to another
|
||
|
|
with ease.
|
||
|
|
See the \fIcdk_screen\fR manual page for more details.
|
||
|
|
.PP
|
||
|
|
.SH STANDARD WIDGET BEHAVIOR
|
||
|
|
All of the widgets have a member of the structure called \fIexitType\fR.
|
||
|
|
This member states how the widget exited.
|
||
|
|
There are three values in which to check
|
||
|
|
for, they are as follows:
|
||
|
|
.LP
|
||
|
|
.TS
|
||
|
|
center tab(/) allbox;
|
||
|
|
l l
|
||
|
|
l l
|
||
|
|
lw15 lw35 .
|
||
|
|
\fBValue/Meaning\fR
|
||
|
|
=
|
||
|
|
vNORMAL/T{
|
||
|
|
This means the widget exited normally.
|
||
|
|
This value is set when the widget is given the characters TAB or RETURN.
|
||
|
|
T}
|
||
|
|
vEARLY_EXIT/T{
|
||
|
|
This means the widget exited early.
|
||
|
|
This value is set when characters such as
|
||
|
|
TAB or RETURN are injected into the
|
||
|
|
widget via the injectCDKXXX function and the
|
||
|
|
character injected does not exit the widget.
|
||
|
|
T}
|
||
|
|
vERROR/T{
|
||
|
|
This value states that an error was returned by curses, e.g., if the
|
||
|
|
terminal was disconnected.
|
||
|
|
T}
|
||
|
|
vESCAPE_HIT/T{
|
||
|
|
This value states the user hit ESCAPE to leave the widget.
|
||
|
|
T}
|
||
|
|
vNEVER_ACTIVATED/T{
|
||
|
|
This is the initial state of the value.
|
||
|
|
This means that the widget has not been activated.
|
||
|
|
T}
|
||
|
|
.TE
|
||
|
|
.SH SEE ALSO
|
||
|
|
.BR cdk_binding (3),
|
||
|
|
.BR cdk_display (3),
|
||
|
|
.BR cdk_draw (3),
|
||
|
|
.BR cdk_misc (3),
|
||
|
|
.BR cdk_process (3),
|
||
|
|
.BR cdk_screen (3)
|
||
|
|
.
|
||
|
|
.SH NOTES
|
||
|
|
.PP
|
||
|
|
The header file \fI<cdk.h>\fR automatically includes the header files
|
||
|
|
\fI<curses.h>\fR,
|
||
|
|
\fI<stdlib.h>\fR,
|
||
|
|
\fI<string.h>\fR,
|
||
|
|
\fI<ctype.h>\fR,
|
||
|
|
\fI<unistd.h>\fR,
|
||
|
|
\fI<dirent.h>\fR,
|
||
|
|
\fI<time.h>\fR,
|
||
|
|
\fI<errno.h>\fR,
|
||
|
|
\fI<pwd.h>\fR,
|
||
|
|
\fI<grp.h>\fR,
|
||
|
|
\fI<sys/stat.h>\fR, and
|
||
|
|
\fI<sys/types.h>\fR.
|
||
|
|
The \fI<curses.h>\fR header file includes \fI<stdio.h>\fR and \fI<unctrl.h>\fR.
|