Important: The information in this document is obsolete and should not be used for new development.
SetTSMCursor
TheSetTSMCursor
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. TheSetTSMCursor
function allows the text service component to control the shape of the cursor if appropriate.Call
SetTSMCursor
whenever you would normally call the QuickDrawSetCursor
procedure. WhenSetTSMCursor
returnsTRUE
, 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. WhenSetTSMCursor
returnsFALSE
, the cursor has not been set, and your client application may set it.
SetTSMCursor
calls the equivalent text service component functionSetTextServiceCursor
(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 callSetTextServiceCursor
for the rest of the text service components and returnsTRUE
. If none of the text service components sets the cursor, thenSetTSMCursor
returnsFALSE
.SEE ALSO
TheSetCursor
procedure is described in the QuickDraw chapters of Inside Macintosh: Imaging.