Legacy Document

Inside Macintosh: Text /

Chapter 7 - Text Services Manager / Text Services Manager Reference

Text Services Manager Routines for Client Applications / Passing Menu Selections and Cursor Setting

SetTSMCursor

The SetTSMCursor function 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.

FUNCTION SetTSMCursor (mousePos: Point): Boolean;

mousePos

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

DESCRIPTION

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 procedure. When SetTSMCursor returns TRUE, the cursor is positioned in a text service component window or in the active input area and it has been set by a text service component. Your client application should not set the cursor in this case. When SetTSMCursor returns FALSE, the cursor has not been set, and your client application may set it.

SetTSMCursor calls the equivalent text service component function SetTextServiceCursor (page 7-88) for each open text service component to provide an opportunity for each one to set shape of the cursor. 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. If none of the text service components sets the cursor, then SetTSMCursor returns FALSE.

SEE ALSO

The SetCursor procedure is described in the QuickDraw chapters of Inside Macintosh: Imaging.