Description

A read/write property setting the current ActiveImage.

Property type

A McImage object.  

Syntax

[Set] object.ActiveImage [= McImage]

The ActiveImage Property syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McEngine.
McImageA McImage object.

Remarks

This must be assigned either Nothing (for no ActiveImage) or an instance of an McImage interface (see McImages.Add).

Notes

When this property is assigned a value, notify clients of McObject(Engine) are sent an SNC_NOTIFY_HO_PROPERTYCHANGED SpecialNotify with data value ID_IMcEngine_ActiveImage. Alternatively, you could become a notify client of Engine.ActiveImageAlias and process ValueChanged standard notifies on that object.

A notify is sent for a Nothing assignment to the ActiveImage only if there are no Visible McImage instances in the Images collection, other than the one that previously was the ActiveImage. This rule avoids unnecessary notifications when the ActiveImage is only temporarily set to Nothing before being switched to the next visible image.