![]() |
TXNDragTracker |
||||
Header: | MacTextEditor.h | Carbon status: | Supported | |
Handles tracking a drag event in a text object for which a custom drag handler is already in place.
OSErr TXNDragTracker ( TXNObject iTXNObject, TXNFrameID iTXNFrameID, DragTrackingMessage iMessage, WindowRef iWindow, DragReference iDragReference, Boolean iDifferentObjectSameWindow );
A variable of type TXNObject. Pass the text object in which you need to track a drag event.
A variable of type TXNFrameID. Pass a frame ID identifying the frame of the text object in which you need to track a drag event. You obtain a frame ID from TXNNewObject.
A drag message obtained from Drag Manager.
A pointer to the window containing the text object in which you need to track a drag. The Drag Manager provides this pointer to your drag handler.
A variable of type DragReference. Pass a reference to the drag that you want MLTE to handle. The Drag Manager provides this reference to your drag handler.
A variable of type Boolean. If your application is displaying more than one text object per window, pass true when the drag operation moves out of one objects view rectangle and into another text objects view rectangle.
A result code. A Drag Manager result code.
You would not typically use the TXNDragTracker function, because MLTE provides basic drag management for you.
However, you might call TXNDragTracker if your application needs to examine the dragged data prior to MLTE handling it, or if you have multiple text objects in a window, or if you have your own drag management infrastructure that you want to use.
You must inform MLTE that you wish to handle some aspect of the drag process by passing the TXNFrameOptions value kTXNDoNotInstallDragProcsMask in the iFrameOptions parameter of TXNNewObject. If you do so, you are responsible for calling the drag handlers for the drag operation. Then, you should call TXNDragTracker when your drag tracker is called and you want MLTE to take over control of the drag tracking process.
Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.
© 2000 Apple Computer, Inc. (Last Updated 7/17/2000)