MrmRegisterClass

Motif 2.1 Programmer's Reference

MrmRegisterClass

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

Format

#include <Mrm/MrmPublic.h>
Cardinal MrmRegisterClass
MrmType
class_codeString class_nameString
create_nameWidget (*create_proc)
()WidgetClass class_record

DESCRIPTION

The MrmRegisterClass function 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 creation function and to do type conversion of argument lists by using the information in MRM databases.

class_code

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

class_name

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

create_name

Specifies the case-sensitive name of the low-level widget creation function for the class. An example from the Motif Toolkit is XmCreateLabel. Arguments are parent_widget, name, override_arglist, and override_argcount.

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

create_proc

Specifies the address of the creation function that you named in create_name.

class_record

Specifies a pointer to the class record.

RETURN

This function returns one of the following status return constants:

MrmSUCCESS

The function executed successfully.

MrmFAILURE

The function failed.