Description

A LONGRECT giving the portion of the ImageToDisplay that could be changed by a pasted image.

Property type

A Variant value.  

Syntax

object.EditPasteAoiRectangle([AlignLeftTop], [ImageToPaste])

The EditPasteAoiRectangle Property syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McDisplay.
AlignLeftTopOptional. A Variant value.

VARIANT : If given, the alignment to use for computing the blending rectangle. If the AlignLeftTop argument is not given, then it is set so that the left,top of the clipboard image AOI bounds is aligned with the left,top of the ImageToDisplay AOI bounds.

ImageToPasteOptional. A Variant value.

VARIANT : If given, the blending image to use for computing the blending rectangle. If not given, then any image on the clipboard is used as it would be for the EditPasteNew or EditPasteAoi methods.

Remarks

The portion of the ImageToDisplay property that would be covered by the ImageToPaste argument (the clipboard image by default) during an EditPasteAoi operation is determined by the sizes of the two images, by the AlignLeftTop blending alignment argument (by default aligning the image AOI's) and by the BlendingStyle property mvbsMaskBySourceAoi and mvbsMaskByDestAoi flags. The rectangle is returned as a LONGRECT struct (left,top,right,bottom As long) in ImageToDisplay coordinates.

This rectangle is clipped to the ImageToDisplay bounds but may extent beyond the displayed portion of the image: its purpose is to see what portion of the ImageToDisplay would be affected if an McGeometry.Blend operation were performed to paste the ImageToPaste argument into the ImageToDisplay.

The rectangle can be “empty” if the blend alignment is far enough off or if masking by the AOI(s) is enabled and their intersection is empty. In this case, the returned LONGRECT “left” field will be larger than the “right” value (see Example).