Museum

 MrmRegisterClass(Xm)           6 January 1993           MrmRegisterClass(Xm)


 Name

    MrmRegisterClass - saves the information needed for MRM to access the
    widget creation function for user-defined widgets

 Syntax


    #include <Mrm/MrmPublic.h>

    Cardinal MrmRegisterClass(class_code, class_name, create_name,
                              create_proc, class_record)
    MrmType class_code;
    String class_name;
    String create_name;
    Widget (*create_proc) ();
    WidgetClass class_record;


 Description

    The MrmRegisterClass function allows MRM to access user-defined widget
    classes.  This function registers the necessary information for MRM to
    create widgets of this class.  You must call MrmRegisterClass prior to
    fetching any user-defined class widget.

    MrmRegisterClass saves the information needed to access the widget crea-
    tion function and to do type conversion of argument lists by using the
    information in MRM databases.

    classcode
            This argument is ignored; it is present for compatibility with
            previous releases.

    classname
            This argument is ignored; it is present for compatibility with
            previous releases.

    createname
            Specifies the case-sensitive name of the low-level widget crea-
            tion function for the class.  An example from the Motif Toolkit
            is XmCreateLabel.  Arguments are parentwidget, name,
            overridearglist, and overrideargcount.

            For user-defined widgets, createname is the creation procedure
            in the UIL that defines this widget.

    createproc
            Specifies the address of the creation function that you named
            increatename.

    classrecord
            Specifies a pointer to the class record.

 Return value

    This function returns one of these status return constants:

    MrmSUCCESS
            The function executed successfully.

    MrmFAILURE
            The function failed.