Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

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.