Click or drag to resize

IMcEngineActiveImage Property

A read/write property setting the current ThisApplication.ActiveImage.

Namespace:  MediaCy.IQL.Engine
Assembly:  MediaCy.IQL.Engine (in MediaCy.IQL.Engine.dll) Version: 10.0.6912.0
Syntax
VB
Copy
Property ActiveImage As McImage
	Get
	Set

Return Value

Type: McImage
IMcImage* The current ThisApplication.ActiveImage instance or Nothing if there is no current active image..
Remarks
This must be assigned either Nothing (for no ActiveImage) or an instance of an McImage interface (see McImages.Add).
Note Note
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 ThisApplication.ActiveImage only if there are no Visible McImage instances in the Images collection, other than the one that previously was the ThisApplication.ActiveImage. This rule avoids unnecessary notifications when the ThisApplication.ActiveImage is only temporarily set to Nothing before being switched to the next visible image.
Examples
VB
Copy
'Test for any Active Image
If ThisApplication.ActiveImage Is Nothing Then Exit Sub
'Set a form caption
Form.Caption = "My Form - " + ThisApplication.ActiveImage.DisplayName
See Also