Carbon


TEIdle

Header: TextEdit.h Carbon status: Not Recommended

When called repeatedly, displays a blinking caret at the insertion point, if any exists, in the text of the specified edit structure of an active window.

void TEIdle (
    TEHandle hTE
);
Parameter descriptions
hTE

A handle to the edit structure.

DISCUSSION

You need to call TEIdle only when the window containing the text is active; the caret is blinked only then. TextEdit observes a minimum blink interval, initially set to 32 ticks. No matter how often you call TEIdle, the time between blinks is never less than the minimum interval. (The user can adjust the minimum interval setting with the General Controls control panel.)

To maintain a constant frequency of blinking, you need to call TEIdle at least once each time through your main event loop. Call it more than once if your application does an unusually large amount of processing each time through the loop.

Call the Event Manager’s GetCaretTime function to get the blink rate.

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)