copa - 1.0 gui control panel kit - C language API This summarizes the copa
C function API. The C function API is virtually identical to the shell API
described in copa(1); differences or points of confusion will be described
here. When copa is installed, the archive library copa.a is built and
placed in the $COPA_HOME directory. Application programs will need to be
linked with this library, as well as xlib (-lX11). Solaris 2.x systems
will also need -lposix4. See $COPA_HOME/examples/Makefile for more
information. The C API does not use the client-server scheme as used by
the shell API described in copa(1). Please refer to copa(1) for
descriptions of functions and arguments. All functions which produce a
result in the shell API, copy the result string into the response argument
in the C language API. All functions return 0 normally, or a non-zero error
number if a severe error occurred.
copa_window( int win_x, int win_y, double win_w, double win_h, char *title,
double bkclr ) In contrast to the shell api, all arguments are required.
copa_version() copa_pop( char *msg, char *choices, char *response )
copa_poplist( char *msg, char *choices, char *buttons, char *response )
copa_popentry( char *msg, char *def, int len, char *response ) copa_popmsg(
char *msg, char *buttons ) copa_popclear() copa_panload( char *panfile,
char *tag ) copa_panuse( char *tag ) copa_panadd( char *panfile )
copa_panquit() copa_panel( char *action, char *panfile, char *tag )
copa_load( char *fnm ) copa_text( char *tag, char *txt ) copa_echo( char
*txt ) copa_get( char *response ) copa_mget( char *rtyp, char *response )
copa_getentry( char *tag, char *response ) The inftype errorcode is not
available; errorcodes are returned by functions. copa_setvalue( char *tag,
char *value ) copa_getvalue( char *tag, char *results ) copa_setmec( char
*tag, char *attr, char *value ) copa_getmec( char *tag, char *attr, char
*response ) copa_rlimit( char *meclist ) copa_rinfo( char *inftyp, char
*response ) copa_resize( int win_x, int win_y, double win_w, double win_h,
double bkclr ) copa_display( char *action ) ping has no meaning in the C
api context. copa_ps( char *name, char *fnm, char *paper ) copa_quit()
$COPA_HOME/copa.a - object library. copa(1)
|