Name

XmHTMLTextSetStringWithLength - set a (new) HTML source text in a XmHTML widget.

Synopsis

void XmHTMLTextSetStringWithLength(Widget w, String text, size_t len)

Description

XmHTMLTextSetStringWithLength loads a HTML source text in a XmHTML widget. The previously displayed document is destroyed.

The sole difference with the XmHTMLTextSetString convenience function is that the text argument need not be null terminated. This function allows one to display text as it is being received and can be used as a limited form of dynamic document loading.

w

Specifies the widget ID of a widget of class xmHTMLWidgetClass

text

Specifies the new source text. A value of NULL effectively erases the currently displayed document without displaying a new document. The widget will make a private copy of this new source, so one can safely free text when this function returns.

len

length of text.

See Also

XmHTML(3X), XmHTMLTextGetSource(3X), XmHTMLTextGetString(3X)