ProcessDropImage Method

Summary

Processes the image dropped on this ImageViewer during a drag/drop operation.

Syntax

C++/CLI

protected virtual void ProcessDropImage( 
   ImageViewerItem targetItem, 
   RasterImage image, 
   bool isFloaterImage, 
   LeadMatrix transform 
)

protected:  
   virtual void ProcessDropImage( 
      ImageViewerItem^ targetItem, 
      RasterImage^ image, 
      bool isFloaterImage, 
      LeadMatrix^ transform 
   )

Parameters

targetItem

The target item for the drop.

image

The image being dropped.

isFloaterImage

true if image is the floater image of another item, otherwise; false.

transform

The transformation matrix of image.

Remarks

This method is called by the viewer as the final step when an image is dropped into an item. The following is the default implementation (to customize it, create a new class that derives from ImageViewer and override this method):

If targetItem is null, then the viewer will create a new ImageViewerItem, set image into ImageViewerItem.Image and adds the item to the viewer.

If targetItem is not null then the following is performed:

If the value of isFloaterImage is true and targetItem has a valid image, then image will be set into ImageViewerItem.Floater and

transform into ImageViewerItem.FloaterTransform. In other words, the image will be added as a floater to the item.

If the value of isFloaterImage is false, the image will be set in Image is ignored. In other words, the image will replace the existing the image in the item (if any).

Requirements

Target Platforms