XmRegisterSegmentEncoding(3X)



     XmRegisterSegmentEncoding(3X)  OSF  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 (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
                 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 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).









     1                                                (printed 6/8/92)
Museum
