Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
XmStringGenerate(3)	   Library Functions Manual	   XmStringGenerate(3)

       XmStringGenerate	 --  A	convenience function that generates a compound

       #include	<Xm/Xm.h>
       XmString	XmStringGenerate(
       XtPointer text,
       XmStringTag tag,
       XmTextType type,
       XmStringTag rendition);

       XmStringGenerate	calls the XmStringParseText function  with  a  default
       parse  table  of	entries	consisting of '', which	maps to	Separator, and
       '', which maps to Tab.  Matching	RENDITION_BEGIN	and RENDITION_END com-
       ponents containing rendition are	placed around the resulting XmString.

       text	 Specifies a NULL-terminated string containing characters of a
		 type determined by type.

       tag	 Specifies the tag to be used in creating the result. The type
		 of  tag  created (charset or locale) depends on the text type
		 and the value given. If specified value is NULL, and type in-
		 dicates  that	a  charset tag should be created, then the tag
		 will have the value of	 XmFONTLIST_DEFAULT_TAG.   If  tag  is
		 NULL, and type	indicates a locale tag,	then the tag will have
		 the value of _MOTIF_DEFAULT_LOCALE.

       type	 Specifies the type of text to be passed in, and the tag type.
		 If  a	locale tag should be created, then type	has a value of
		 either	XmMULTIBYTE_TEXT  or  XmWIDECHAR_TEXT.	If  a  charset
		 should	be created, type has a value of	XmCHARSET_TEXT.

       rendition Specifies  the	rendition tag to be used in an XmSTRING_COMPO-
		 NENT_RENDITION_BEGIN component	which will begin the  returned
		 string	 and  in an XmSTRING_COMPONENT_RENDITION_END component
		 which will end	it.  If	rendition is NULL, no rendition	tag is

       Returns	a  new	compound  string.  The function	will allocate space to
       hold the	returned compound string.   When  the  application  no	longer
       needs  the  returned  compound  string, the application should call Xm-

       XmString(3) and XmStringFree(3).



Want to link to this manual page? Use this URL:

home | help