Legacy Document

Inside Macintosh: Text /

Chapter 2 - TextEdit / TextEdit Reference

Routines / Activating and Deactivating an Edit Record

TEActivate

The TEActivate procedure activates the specified edit record.

PROCEDURE TEActivate (hTE: TEHandle);

hTE

A handle to the specified edit record.

DESCRIPTION

When you call TEActivate for an edit record, the selection range is highlighted. If the selection range is an insertion point, TEActivate displays a caret there.

Call this procedure every time the Event Manager function WaitNextEvent reports that the window containing the edit record has become active.

If you do not call TEActivate before you call TEClick, TEIdle, or TESetSelect, the selection range is not highlighted, or, if the selection range is set to an insertion point, a caret is not displayed at the insertion point. However, if you have turned on outline highlighting through the TEFeatureFlag function for the edit record, the text of the selection range is framed or a dimmed or an unblinking caret is displayed at the insertion point.

SEE ALSO

For a description of the WaitNextEvent function, see the chapter "Event Manager" in Inside Macintosh: Macintosh Toolbox Essentials.