set-text

Generic Function

Package: common-graphics

Arguments: widget value

Sets the contents of text-edit-pane to be string. For line breaks, the string may contain either single #\Newline or #\Linefeed characters, or #\Return #\Linefeed (CR/LF) pairs.

The other way to replace all of the text in a text-edit-pane (assuming that it is not associated with a multi-line-editable-text control) is to call clear-page on the pane and then write text to it with standard Common Lisp stream output functions (like format).

Note: set-text would actually work when called on certain other objects, but is too low-level for application use for all but text-edit-pane. Specifically, set-text would also set the contents of a multi-line-editable-text control, but (setf value) should be used instead so that the control's current value will reflect the current string. Similarly, set-text would set the title of a frame-window (as well as other things), but (setf title) should be used instead so that the window will remember the title.

See also get-text, which returns (as a string) the text in a text-edit-pane and in text controls.

Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.

The documentation is described in introduction.htm and the index is in index.htm.

Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.

Created 2000.10.5.