XmRegisterSegmentEncoding(3X)



SDK X11 R4.11MU05                              XmRegisterSegmentEncoding(3X)


NAME
       XmRegisterSegmentEncoding--A compound string function that registers
       a compound text encoding format for a specified font list element tag

SYNOPSIS
       #include <Xm/Xm.h>

       char * XmRegisterSegmentEncoding (fontlisttag, ctencoding)
            char   *fontlisttag;
            char   *ctencoding;


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 ctencoding parameter.


        fontlisttag
               Specifies the font list element tag to be registered.  The
               tag must be a NULL-terminated ISO8859-1 string.

        ctencoding
               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
               XmFONTLISTDEFAULTTAG 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 ctencoding 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).


Licensed material--property of copyright holder(s)
Museum
