XmRepTypeRegister(3X) UNIX System V XmRepTypeRegister(3X)
NAME
XmRepTypeRegister - A representation type manager function
that registers a representation type resource
SYNOPSIS
#include <Xm/RepType.h>
XmRepTypeId XmRepTypeRegister (rep_type, value_names, values, num_values)
String rep_type;
String *value_names;
unsigned char*values;
unsigned charnum_values;
VERSION
This page documents version 1.2 of the Motif library.
DESCRIPTION
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.
Note that the numerical representation type values have type
(unsigned char).
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
Page 1 (printed 4/30/98)
XmRepTypeRegister(3X) UNIX System V XmRepTypeRegister(3X)
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.
rep_type Specifies the representation type name.
value_names 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.
values 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.
num_values Specifies the number of entries in the
value_names and values arrays.
RETURN VALUE
Returns the identification number for the specified
representation type.
RELATED INFORMATION
XmRepTypeAddReverse(3X), XmRepTypeGetId(3X),
XmRepTypeGetNameList(3X), XmRepTypeGetRecord(3X),
XmRepTypeGetRegistered(3X), and XmRepTypeValidValue(3X).
Page 2 (printed 4/30/98)