BOOTSTRAP (kcms) functions


LIBRARY ROUTINE

kcms_generate_cmobj - create and initialize a software object

LIBRARY CALL

kobject
kcms_generate_cmobj(
   kobject        toolbox,
   kstring        oname,
   unsigned long  otype,
   kstring        bname,
   kstring        cat,
   kstring        subcat,
   kstring        description,
   kstring        lname,
   unsigned long  ltype,
   int            form,
   int            pane,
   int            ci,
   kobject        template_object)

INPUT

OUTPUT

none

RETURN VALUE

TRUE (1) on success, FALSE (0) otherwise

DESCRIPTION

This routine is a high-level interface to kcms_create_cmobj() that will create an empty software, and then set some attributes about the cmobj. These attributes include bname, l*.c file, adding a template pane or form, language dependancies, category, and sub-category information. The description variable contains the short description of the new object. Note the first three parameters MUST be valid input. If they are invalid values, this routine will return an error. The parameters starting with [bname] are optional, and an value of FALSE or NULL depending on the type implies that the option is not set and a default value is used. Also, if the template_object is not NULL, default values for the optional parameters will be taken from the values that are set in the template.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$BOOTSTRAP/objects/library/kcms/src/cmobj_gen.c

SEE ALSO

kcms(3)

COPYRIGHT

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