![]() |
HiliteWindowFrameForDrag |
||||
Header: | MacWindows.h | Carbon status: | Supported | |
Sets the highlight state of the windows structure region to reflect the windows validity as a drag-and-drop destination.
OSStatus HiliteWindowFrameForDrag ( WindowRef window, Boolean hilited );
A pointer to the window for which you wish to set the highlight state.
true if the windows frame should be highlighted; otherwise, false.
A result code.
Applications typically call the Drag Manager functions ShowDragHilite and HideDragHilite to indicate that a window is a valid drag-and-drop destination. If your application does not do thisthat is, if your application implements any type of custom drag highlighting, such as highlighting more than one area of a window at a timeit must call the HiliteWindowFrameForDrag function.
The HiliteWindowFrameForDrag function highlights a windows proxy icon when the user drags content inside the window that is a valid content type for that destination. The default behavior of system-defined windows is to highlight the proxy icon along with the windows content area when the window is a valid drag-and-drop destination. If you call the Drag Manager functions ShowDragHilite and HideDragHilite, you dont need to use HiliteWindowFrameForDrag.
This function is available with Mac OS 8.5 and later.
Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.
© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)