AmbientChanged Event 533

Applies To: ActiveXContainer, ActiveXControl

Description

If enabled, this event is reported when any of the ambient properties change in an application hosting an ActiveXControl object. The new values of the ambient properties are available from the FontObj, BCol and FCol properties of the ActiveXContainer.

This event is reported for information alone. You may not disable or nullify the event by setting the action code for the event to ¯1 or by returning 0 from a callback function.

The event message reported as the result of ⎕DQ, or supplied as the right argument to your callback function, is a 4-element vector as follows :

[1]	Object	ref or character vector
[2]	Event	'AmbientChanged' or 533
[3]	Property code	integer
[4]	Description	character vector

For properties supported by Dyalog APL, Property code and Description may be one of the following:

Property code	Description	Meaning
¯701	DISPID_AMBIENT_BACKCOLOR	BCol has changed
¯703	DISPID_AMBIENT_FORECOLOR	FCol has changed
¯705	DISPID_AMBIENT_FONT	Font has changed
¯1	DISPID_AMBIENT_UNKNOWN	Unknown

Note that other ambient properties may be reported, although these have no corresponding Dyalog APL property.