XmRegisterSegmentEncoding(library calXlm)RegisterSegmentEncoding(library call)




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

 SYNOPSIS    [Toc]    [Back]
      #include <Xm/Xm.h>
      char * XmRegisterSegmentEncoding(
      char *fontlist_tag,
      char *ct_encoding);

 DESCRIPTION    [Toc]    [Back]
      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 NULLterminated
 ISO8859-1 string.  A value of
                XmFONTLIST_DEFAULT_TAG maps the specified font list tag to
                the code set of the locale.

 RETURN    [Toc]    [Back]
      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    [Toc]    [Back]
      XmCvtXmStringToCT(3), XmFontList(3), XmMapSegmentEncoding(3), and
      XmString(3).


                                    - 1 -       Formatted:  January 24, 2005