XmRepTypeRegister(3X)
Prev | Reference Pages | Next

## Name

XmRepTypeRegister(3X) — XmRepTypeRegister--A representation type manager function that registers a representation type resource XmRepTypeRegisterrepresentation type manager functions

## Synopsis

#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

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.

`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).

Prev | Table of Contents | Next
XmRepTypeInstallTearOffModelConverter(3X) |  | XmRepTypeValidValue(3X)