Ambient Properties for Controls

If a control supports any ambient properties at all, it must at least respect the values of the following ambient properties under the conditions stated in the following table using the standard dispids.

Ambient Property Dispid Comment/Conditions for Use

LocaleID

-705

If Locale is significant to the control, e.g. for text output

UserMode

-709

If the control behaves differently in user (design) mode and run mode

UIDead

-710

If the control reacts to UI events, then it should honor this ambient property

ShowGrabHandles

-711

If the control support in-place resizing of itself

ShowHatching

-712

If the control support in-place activation and UI activation

DisplayAsDefault

-713

Only if the control is marked OLEMISC_ACTSLIKEBUTTON (which means that support for keyboard mnemonics is provided, thus IOleControl::GetControlInfo and IOleControl::OnMnemonic must be implemented).

 

As described previously, use of ambients requires both IOleControl (for OnAmbientPropertyChange as a minimum) as well as IOleObject (for SetClientSite and GetClientSite).

The OLEMISC_SETCLIENTSITEFIRST bit may not necessarily be supported by a container. In these circumstances, a control must resort to default values for the ambient properties that it requires.

Related topics

Controls

 

 

Show: