DragLeave

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODPart

DragLeave
The DragLeave method should finish tracking a drag operation and deactivate this part from drag tracking.
void DragLeave (in ODFacet facet,
                in ODPoint where);
facet
A reference to a facet where the drag point is located.
where
The location of the drag point, expressed in frame coordinates.

DISCUSSION
OpenDoc calls this method when the drag point has left the specified facet of this part during a drag operation. After this method executes successfully, the part is guaranteed not to receive DragWithin or Drop messages until you receive another DragEnter message.
Your part's DragLeave method should clean up after a drag operation. For example, you should remove the drag border on the frame, remove highlighting from any content highlighted during drag tracking, and change the cursor appearance back to its original form. In addition, if your part calls one of its display frames' SetDroppable method with a value of kODTrue, you must override this method and implement the protocol for drag highlighting and accepting dropped data.

OVERRIDING
When you subclass ODPart, you can override this method. Your override method must not call its inherited method; that is, your override method must implement this method's functionality completely.

EXCEPTIONS

kODErrDoesNotDrop
This part does not support drag and drop.

SEE ALSO
The ODPoint type (page 885).
The ODFrame::SetDroppable method (page 333).
The ODPart::DragEnter method (page 500).
The ODPart::DragWithin method (page 503).
The ODPart::Drop method (page 506).
Table 2-1 on page 89 in OpenDoc Programmer's Guide.
"On Leaving a Part's Facet" on page 364 in OpenDoc Programmer's Guide.