![]() |
FindServiceWindow |
||||
Header: | TextServices.h | Carbon status: | Unsupported | |
Determines which part of a text service components floating window a mouse-down event has occurred in.
SInt16 FindServiceWindow ( Point thePoint, WindowRef *theWindow );
The point where the mouse button was pressed (in global coordinates, as stored in the where field of the Event Manager event structure).
A pointer to a Window Manager window pointer (defined by the WindowPtr data type) that identifies the floating window in which the mouse-down event occurred. If the mouse-down event did not occur in a text service component floating window, this parameter is set to NULL.
FindServiceWindow calls the Window Manager FindWindow function. It returns one of the following predefined constants to identify the location of the mouse-down event.
inDesk:
A value of 0. Indicates that the location of the mouse-down event is none of the following.
inMenuBar:
A value of 1. Indicates that the mouse-down event is in the menu bar.
inSysWindow:
A value of 2. Indicates that the mouse-down event is in the system window.
inContent:
A value of 3. Indicates that the mouse-down event is in a content region (except grow, if active).
inDrag:
A value of 4. Indicates that the mouse-down event is in a drag region.
inGrow:
A value of 5. Indicates that the mouse-down event is in the grow region (active window only).
inGoAway:
A value of 6. Indicates that the mouse-down event is in the go-away region (active window only).
inZoomIn:
A value of 7. Indicates that the mouse-down event is in the zoom-in region.
inZoomOut:
A value of 8. Indicates that the mouse-down event is in the zoom-out region.
If the mouse position is not over a floating window, FindServiceWindow returns inDesk (0) as its function result, and sets the return parameter theWindow to NULL.
The FindServiceWindow function is similar to the Window Manager FindWindow function, except that FindServiceWindow searches the floating window service layer only.
Not supported in Carbon. Not available in Carbon.
You should use Mac OS 8.5 Window Manager functions to create floating windows. Then, you should replace calls to FindServiceWindow with calls to the Window Manager function FindWindow.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)