Carbon


TEDelete

Header: TextEdit.h Carbon status: Not Recommended

Removes the selected range of text from the designated edit structure, redrawing the remaining text as necessary.

void TEDelete (
    TEHandle hTE
);
Parameter descriptions
hTE

A handle to the edit structure containing the text to be deleted.

DISCUSSION

When the TEDelete function deletes a selected range of text, it does not transfer the text to either the private scrap or the Scrap Manager’s desk scrap.

For multistyled structures, when you use TEDelete to delete a selected range of text, the associated character attributes are saved in the null scrap to be applied to characters entered after the text is deleted. When the user clicks in some other area of the text, the character attributes are removed from the null scrap. You can use TEDelete to implement the Clear command. The TEDelete function recalculates line starts and line heights.

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)