LessTif Manual Page - XmString Functions

XmString

XmString Functions

Synopsis

Dimension XmStringBaseline(XmFontList fontlist, XmString string)

Boolean XmStringByteCompare(XmString s1, XmString s2)

Boolean XmStringCompare(XmString s1, XmString s2)

XmString XmStringConcat(XmString s1, XmString s2)

XmString XmStringCopy(XmString string)

XmString XmStringCreate(char *text, char *tag)

XmString XmStringCreateSimple(char *text)

XmStringDirection

void XmStringDraw(Display *dpy, Window win, XmFontList fontlist, XmString string, GC gc, Position x, Position y, Dimension width, unsigned char alignment, unsigned char layout_direction, XRectangle *clip)< p>

void XmStringDrawImage(Display *dpy, Window win, XmFontList fontlist, XmString string, GC gc, Position x, Position y, Dimension width, unsigned char alignment, unsigned char layout_direction, XRectangle *clip)< p>

void XmStringDrawUnderline(Display *dpy, Window win, XmFontList fontlist, XmString string, GC gc, Position x, Position y, Dimension widget, unsigned char alignment, unsigned char layout_direction, XRectangle *clip, XmString underline)

Boolean XmStringEmpty(XmString string)

void XmStringExtent(XmString string, Dimension *width, Dimension *height)

void XmStringFree(XmString string)

Boolean XmStringHasSubstring(XmString string, XmString substring)

Dimension XmStringHeight(XmFontList fontlist, XmString string)

Dimension XmStringLength(XmFontList fontlist, XmString string)

int XmStringLineCount(XmString string)

XmString XmStringNConcat(XmString s1, XmString s2, int num_bytes)

XmString XmStringNCopy(XmString str, int num_bytes)

XmString XmStringSeparatorCreate()

Dimension XmStringWidth(XmFontList fontlist, XmString string)

Description

This distinction is important, because when an XmString is passed to a widget, it is sometimes converted to an simplfied internal format. This has the side effect of removing redundant or unnecessary information. When the XmString is retrieved using a function like XtVaGetValues, it is converted from the internal format, but the extra information is not restored. Therefore, it is possible to have two XmStrings that contain the same information, but do not match.

XmStringCompare compares two XmStrings to see if they are semantically equivalent.