This is NSDraggingInfo.rtf in view mode; [Download] [Up]
paperh18648 margl-907 margr0 margt0 margb0 fi0 ri0 ql sb0 f1 fs24 Copyright f3 'e3f1 1994 by NeXT Computer, Inc. All Rights Reserved.
s12 li100 fi0 ri1007 ql f0 b fs36 fs100
fs36 NSDraggingInfo
pard s1 li2872 fi-2771 ri1007 ql tx2872 f1 b0 fs28 fs48
fs28 f0 b fs24 Adopted By:tab b0 fs28 f1 no OpenStep classes
fs20
fs28 s17 f0 b fs24 Declared In:tab b0 fs28 f1 AppKit/NSDragging.h
fs20
fs28 pard s45 li100 fi0 ri1007 ql f0 b fs28 fs20
fs28 Protocol Description
fs14
fs28 pard s3 li477 fi0 ri1007 ql tx2494 tx2872 tx3250 f1 b0 fs2
fs28 The NSDraggingInfo protocol declares methods that supply information about a dragging session (see the NSDraggingDestination protocol, an informal protocol of NSObject, for definitions of dragging terms). A view or window first registers dragging types; it may then send NSDraggingInfo protocol messages while dragging occurs to get details about that dragging session.
fs16
fs28 NSDraggingInfo methods are designed to be invoked from within an object'27s implementation of the NSDraggingDestination protocol methods. An object that conforms to NSDraggingInfo is passed as the argument to each of the methods defined by NSDraggingDestination; NSDraggingInfo messages should be sent to this conforming object. The Application Kit supplies an NSDraggingInfo object automatically so that you never need to create a class that implements this protocol.
fs16
fs28 pard s45 li100 fi0 ri1007 ql f0 b fs24
fs28 Dragging-Session Information
fs14
fs28 pard s20 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (NSWindow *)b draggingDestinationWindowtab b0 Returns the destination'27s Window.
fi-6552 fs16
fs28 fi-6552 {f3 -} (NSPoint)b draggingLocationtab b0 Returns the current location of the cursor'27s hot spot, reckoned in the base coordinate system of the destination object'27s Window.
fi-6552 fs16
fs28 fi-6552 {f3 -} (NSPasteboard *)b draggingPasteboardtab b0 Returns the Pasteboard that holds the dragged data.
fi-6552 fs16
fs28 fi-6552 {f3 -} (int)b draggingSequenceNumbertab b0 Returns a number that uniquely identifies the dragging session.
fi-6552 fs16
fs28 fi-6552 {f3 -} (id)b draggingSourcetab b0 Returns the source, or 'aaowner,'ba of the dragged image. Returns b nilb0 if the source isn'27t in the same application as the destination.
fi-6552 fs16
fs28 fi-6552 {f3 -} (NSDragOperation)b draggingSourceOperationMask
s22 li7030 fi-6553 fi-5796 b0 tab Returns the operation mask declared by the source.
pard s45 li100 fi0 ri1007 ql f0 b fs48
fs28 Image Information
fs14
fs28 pard s20 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (NSImage *)b draggedImagetab b0 Returns the image object that'27s being dragged. Don'27t invoke this method after the user has released the image, and don'27t release the object that this method returns.
fi-6552 fs16
fs28 fi-6552 {f3 -} (NSPoint)b draggedImageLocationtab b0 Returns the current location of the dragged image'27s origin. The image moves in lockstep with the cursor (the position of which is given by b draggingLocationb0 ) but may be positioned at some offset. The point that'27s returned is reckoned in the base coordinate system of the destination object'27s Window.
pard s45 li100 fi0 ri1007 ql f0 b fs48
fs28 Sliding the Image
fs14
fs28 pard s20 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (void)b slideDraggedImageTo:b0 (NSPoint)i screenPoint
s22 li7030 fi-6553 fi-5796 i0 i tab i0 Slides the image to the given location in the screen coordinate system. This method should only be invoked after the user has released the image but before it'27s removed from the screen.
}These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.