GetExternalDragImage Method

Return an image to be displayed during a drag coming from another window.

Syntax

Visual Basic
C#

'Declaration
 
Protected Overridable Function GetExternalDragImage( _
   ByVal evt As DragEventArgs _
) As GoObject

protected virtual GoObject GetExternalDragImage( 
   DragEventArgs evt
)

Parameters

evt

Return Value

a GoImage that is added to this view, or null not to have any such image

Remarks

This is called by OnDragEnter when an external drag enters this window, unless ExternalDragDropsOnEnter is true. The default implementation just looks at the DragEventArgs.Data. If the data is a GoSelection, it calls GetBitmapFromCollection(IGoCollection,RectangleF,Boolean), using GoDocument.ComputeBounds to determine the size of the bitmap that is returned, and not drawing any paper background color. By default all other data formats are ignored, causing this method to return null. You can return other kinds of GoObjects besides GoImage. The object (if non-null) gets added to this view to be dragged around by the user to represent whatever might be dropped, and is discarded when the drag is finished whether or not a drop occurs. The relative position of the objects compared to the mouse position is obtained from the selection's GoSelection.HotSpot. The object returned by this method has defined its Location so as to return the HotSpot point. The actual side-effects of a drop do not involve the object returned by this method.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

GoView Class
GoView Members