Carbon


TESetSelect

Header: TextEdit.h Carbon status: Not Recommended

Sets the selection range (or denotes the insertion point) within the text of the specified edit structure.

void TESetSelect (
    SInt32 selStart, 
    SInt32 selEnd, 
    TEHandle hTE
);
Parameter descriptions
selStart

The byte offset at the start of the text selection range. The selStart field can range from 0 to 32767.

If selStart equals selEnd, the new selection range is an insertion point, and a caret is displayed. If selEnd is anywhere beyond the last character of the text, TESetSelect uses the first position past the last character.

selEnd

The byte offset at the end of the text selection range. The selEnd field can range from 0 to 32767.

hTE

A handle to the edit structure.

DISCUSSION

The TESetSelect function removes highlighting of the old selection range and highlights the new one.

When only the Roman script system is used, the selection range is always displayed and highlighted as a continuous range of text. However, when one or more script systems requiring mixed-directional display of text are installed, a continuous sequence of characters in memory may appear as a discontinuous selection when displayed.

AVAILABILITY

Not recommended in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)