Museum

 XmRegisterSegmentEncoding(Xm)  6 January 1993  XmRegisterSegmentEncoding(Xm)


 Name

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

 Syntax


    #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 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.

 See also

    XmCvtXmStringToCT(Xm), XmFontList(Xm), XmMapSegmentEncoding(Xm) and
    XmString(Xm).