Carbon


SetTSMCursor

Header: TextServices.h Carbon status: Unsupported

Provides an opportunity for the text service component to set the shape of the cursor. If the text service component does not respond, your application may set the cursor.

Boolean SetTSMCursor (
    Point mousePos
);
Parameter descriptions
mousePos

A QuickDraw point indicating the position (in global coordinates) of the cursor in your application.

function result

If a text service component actually changes the shape of the cursor, the Text Services Manager does not call SetTextServiceCursor for the rest of the text service components and returns TRUE, indicating that your client application should not set the cursor. If none of the text service components sets the cursor, then SetTSMCursor returns FALSE, indicating that your client application may set the cursor.

DISCUSSION

Your client application is responsible for setting the cursor to an appropriate shape as it passes over your various user interface elements. It is also necessary to provide an opportunity for a text service component to set the cursor over its own user interface elements. The SetTSMCursor function allows the text service component to control the shape of the cursor if appropriate.

Call SetTSMCursor whenever you would normally call the QuickDraw SetCursor function. SetTSMCursor calls the equivalent text service component function SetTextServiceCursor for each open text service component to provide an opportunity for each one to set shape of the cursor.

AVAILABILITY

Not supported in Carbon. Not available in Carbon.

CARBON NOTES

Not needed in Mac OS X due to the new event model.


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