XmRepTypeRegister(3X)XmRepTypeRegister(3X)NAMEXmRepTypeRegister - A representation type manager function that regis‐
ters a representation type resource
SYNOPSIS
#include <Xm/RepType.h>
XmRepTypeId XmRepTypeRegister (rep_type, value_names, values, num_val‐
ues)
String rep_type;
String *value_names;
unsigned char *values;
unsigned char num_values;
DESCRIPTIONXmRepTypeRegister 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 man‐
ner 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 repre‐
sentation type name is registered more than once, the behavior is unde‐
fined.
The function XmRepTypeAddReverse installs a reverse converter for a
registered representation type. The reverse converter takes a repre‐
sentation type numerical value and returns the corresponding string
value. If the list of numerical values for a representation type con‐
tains 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 speci‐
fied 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
Returns the identification number for the specified representation
type.
SEE ALSOXmRepTypeAddReverse(3X), XmRepTypeGetId(3X), XmRepTypeGetNameList(3X),
XmRepTypeGetRecord(3X), XmRepTypeGetRegistered(3X), XmRepTypeValid‐
Value(3X)XmRepTypeRegister(3X)
