TESetText

Store initial text into an edit record

#include <TextEdit.h> TextEdit

void TESetText(textPtr, length, hTE );

Ptr textPtr ; address of text for the edit record

long length ; length of text at textPtr

TEHandle hTE ; edit record handle of interest

Associates the specified text with the specified edit record.

textPtr is the address of a string of characters. After the call, this data will

be available for display and editing.

length is a 32-bit value indicating the length of the text at textPtr.; i.e.,

the number of characters in the array.

hTE is a handle obtained via TENew (old style TextEdit record) or

TEStylNew (new style TextEdit record). It leads to a

variable-length TERec structure and identifies the edit record to be

affected by this change.

Notes: The selection range is set to an insertion point after the last

character in the text. You may wish to use TESetSelect to set the selection

range.

The text is not displayed immediately. Use InvalRect to force the text to

be displayed at the next update event for the active window.

On style-aware edit records (see TEStylNew), the style in the

null-scrap (TEStyleRec.nullScrap) is applied to the text.

Instead of creating and disposing multiple edit records, it is often more

efficient to use this call for each piece of text to be edited; e.g., for each field

of a dialog box.

For more information on how to put a string into a TextEdit record, see

Converting TextEdit Records.

Referenced by (7):