xmregistersegmentencoding(3) [redhat man page]

XmRegisterSegmentEncoding(library call) 								   XmRegisterSegmentEncoding(library call)

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(
       char *fontlist_tag,
       char *ct_encoding);

DESCRIPTION

       XmRegisterSegmentEncoding registers a compound text encoding format with the specified font list element tag. The  XmCvtXmStringToCT  func-
       tion  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

       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

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

													   XmRegisterSegmentEncoding(library call)

XmCvtXmStringToCT(3X)													     XmCvtXmStringToCT(3X)

NAME

       XmCvtXmStringToCT - A compound string function that converts a compound string to compound text

SYNOPSIS

       #include <Xm/Xm.h>

       char * XmCvtXmStringToCT (string)
	       XmString string;

DESCRIPTION

       XmCvtXmStringToCT converts a compound string to a (char *) string in compound text format. The application must call XtAppInitialize before
       calling this function. The converter uses the font list tag associated with a given compound string segment to select a compound text  for-
       mat  for  that segment. A registry defines a mapping between font list tags and compound text encoding formats. The converter uses the fol-
       lowing algorithm for each compound string segment: If the compound string segment tag is mapped to XmFONTLIST_DEFAULT_TAG in the  registry,
       the  converter passes the text of the compound string segment to XmbTextListToTextProperty with an encoding style of XCompoundTextStyle and
       uses the resulting compound text for that segment.  If the compound string segment tag is mapped to an MIT registered charset in  the  reg-
       istry,  the  converter creates the compound text for that segment using the charset (from the registry) and the text of the compound string
       segment as defined in the X Consortium Standard Compound Text Encoding.	If the compound string segment tag is mapped to a charset  in  the
       registry  that  is  neither  XmFONTLIST_DEFAULT_TAG nor an MIT registered charset, the converter creates the compound text for that segment
       using the charset (from the registry) and the text of the compound string segment as an "extended segment" with a variable number of octets
       per character.  If the compound string segment tag is not mapped in the registry, the result is implementation dependent.  Specifies a com-
       pound string to be converted to compound text.

RETURN VALUE

       Returns a (char *) string in compound text format. This format is described in the X Consortium Standard Compound Text Encoding.

SEE ALSO

       XmCvtCTToXmString(3X), XmFontList(3X), XmMapSegmentEncoding(3X), XmRegisterSegmentEncoding(3X), XmString(3X)

															     XmCvtXmStringToCT(3X)