DwtString(3Dwt)

Name

DwtString − Creates a compound-string.

Syntax

DwtCompString DwtString(text, charset, direction_r_to_l)
     char *text;
     unsigned long charset;
     char direction_r_to_l;

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

Description

The DwtString function creates a compound-string from information in the argument list. It has a simpler interface than the one used for DwtCSString.

DwtString assumes the following default values:

•For language the default is DwtLanguageNotSpecified.

•For rend the default is DwtRendMaskNone. The space for the resulting compound-string is allocated within the function. After using this function, you should free this space by calling XtFree.

Return Value

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