NAME    [Toc]    [Back]

       XmRepTypeRegister - A representation type manager function
       that registers a representation type resource

SYNOPSIS    [Toc]    [Back]

       #include <Xm/RepType.h>

       XmRepTypeId XmRepTypeRegister (rep_type, value_names, values,
 num_values)
               String rep_type;
               String *value_names;
               unsigned char *values;
               unsigned char num_values;

DESCRIPTION    [Toc]    [Back]

       XmRepTypeRegister registers a representation type resource
       with the representation type manager.  All features of the
       representation  type  management facility become available
       for  the  specified  representation  type.   The  function
       installs a forward type converter to convert string values
       to numerical representation type values.

       When the values argument is  NULL,  consecutive  numerical
       values  are  assumed.   The  order  of  the strings in the
       value_names array determines the numerical values for  the
       resource.   For  example,  the  first value name is 0; the
       second value name is 1; and so on.

       If it is non-NULL, the values  argument  can  be  used  to
       assign values to representation types that have nonconsecutive
 values or have duplicate names for the  same  value.
       Representation  types  registered in this manner will consume
 additional storage and will be slightly  slower  than
       representation types with consecutive values.

       A  representation type can only be registered once; if the
       same representation type  name  is  registered  more  than
       once, the behavior is undefined.

       The  function  XmRepTypeAddReverse installs a reverse converter
 for a registered representation type.  The  reverse
       converter  takes a representation type numerical value and
       returns the corresponding string value.  If  the  list  of
       numerical values for a representation type contains duplicate
 values, the reverse converter uses the first name  in
       the  value_names  list  that matches the specified numeric
       value.  For example, if a value_names  array  has  cancel,
       proceed,  and  abort,  and  the corresponding values array
       contains 0, 1, and 0, the reverse  converter  will  return
       cancel  instead  of abort for an input value of 0.  Specifies
 the representation type name.  Specifies a pointer to
       an array of value names associated with the representation
       type.  A value name is specified in  lowercase  characters
       without an "Xm" prefix.  Words within a name are separated
       with underscores.  Specifies a pointer to an array of values
  associated  with the representation type.  A value in
       this array is associated with the value name in the corresponding
 position of the value_names array.  Specifies the
       number of entries in the value_names and values arrays.

RETURN VALUE    [Toc]    [Back]

       Returns the identification number for the specified representation
 type.

SEE ALSO    [Toc]    [Back]

       XmRepTypeAddReverse(3X), XmRepTypeGetId(3X), XmRepTypeGetNameList(3X),  XmRepTypeGetRecord(3X),  XmRepTypeGetRegistered(3X), XmRepTypeValidValue(3X)



                                            XmRepTypeRegister(3X)