XmRegisterSegmentEncoding(3X)
Prev | Reference Pages | Next

## Name

XmRegisterSegmentEncoding(3X) — XmRegisterSegmentEncoding--A compound string function that registers a compound text encoding format for a specified font list element tag XmRegisterSegmentEncodingcompound string functions

## Synopsis

#include <Xm/Xm.h>
char * XmRegisterSegmentEncoding (`fontlist_tag, ct_encoding`)
char `*fontlist_tag`;
char `*ct_encoding`;

## DESCRIPTION

XmRegisterSegmentEncoding registers a compound text encoding format with the specified font list element tag. The XmCvtXmStringToCT function uses this registry to map the font list tags of compound string segments to compound text encoding formats. Registering a font list tag that already exists in the registry overwrites the original entry. You can unregister a font list tag by passing a NULL value for the `ct_encoding` parameter.

`fontlist_tag` |  | Specifies the font list element tag to be registered. The tag must be a NULL-terminated ISO8859-1 string.
`ct_encoding` |  | Specifies the compound text character set to be used for segments with the font list tag. The value must be a NULL-terminated ISO8859-1 string. A value of XmFONTLIST_DEFAULT_TAG maps the specified font list tag to the code set of the locale.

## RETURN VALUE

Returns NULL for a new font list tag or the old `ct_encoding` value for an already registered font list tag. The application is responsible for freeing the storage associated with the returned data (if any) by calling XtFree.

## RELATED INFORMATION

XmCvtXmStringToCT(3X), XmFontList(3X), XmMapSegmentEncoding(3X), and XmString(3X).

Prev | Table of Contents | Next
XmPushButtonGadget(3X) |  | XmRemoveProtocolCallback(3X)