DwtCSString(3Dwt)

Name

DwtCSString − Creates a compound-string.

Syntax

DwtCompString DwtCSString(text, charset, direction_r_to_l,
                           language, rend)
     char *text;
     unsigned long charset;
     char direction_r_to_l;
     unsigned long language;
     DwtRendMask rend;

Arguments

textSpecifies the text string to be converted to a compound-string.

charsetSpecifies the character set for the compound-string. Values for this argument can be found in the required file /usr/include/cda_def.h.

direction_r_to_l
Specifies the direction in which the text is drawn and wraps. You can pass DwtDirectionLeftDown (text is drawn from left to right and wraps down); DwtDirectionRightUp (text is drawn from left to right and wraps up); DwtDirectionLeftDown (text is drawn from right to left and wraps down); or DwtDirectionLeftUp (text is drawn from right to left and wraps up).

languageIncluded for future use.

rendIncluded for future use.

Description

The DwtCSString function creates a compound-string from information in the argument list. Space for the resulting string is allocated within the function. After using this function, you should free the space by calling XtFree.

Return Values

This function returns the resulting compound-string. However, it returns a NULL pointer if the input string is NULL.