IAxWinAmbientDispatch Interface

This interface provides methods for specifying characteristics of the hosted control or container.

Important

This class and its members cannot be used in applications that execute in the Windows Runtime.

interface IAxWinAmbientDispatch : IDispatch

Members

Methods

get_AllowContextMenu

The AllowContextMenu property specifies whether the hosted control is allowed to display its own context menu.

get_AllowShowUI

The AllowShowUI property specifies whether the hosted control is allowed to display its own user interface.

get_AllowWindowlessActivation

The AllowWindowlessActivation property specifies whether the container will allow windowless activation.

get_BackColor

The BackColor property specifies the ambient background color of the container.

get_DisplayAsDefault

DisplayAsDefault is an ambient property that allows a control to find out if it is the default control.

get_DocHostDoubleClickFlags

The DocHostDoubleClickFlags property specifies the operation that should take place in response to a double-click.

get_DocHostFlags

The DocHostFlags property specifies the user interface capabilities of the host object.

get_Font

The Font property specifies the ambient font of the container.

get_ForeColor

The ForeColor property specifies the ambient foreground color of the container.

get_LocaleID

The LocaleID property specifies the ambient locale ID of the container.

get_MessageReflect

The MessageReflect ambient property specifies whether the container will reflect messages to the hosted control.

get_OptionKeyPath

The OptionKeyPath property specifies the registry key path to user settings.

get_ShowGrabHandles

The ShowGrabHandles ambient property allows the control to find out if it should draw itself with grab handles.

get_ShowHatching

The ShowHatching ambient property allows the control to find out if it should draw itself hatched.

get_UserMode

The UserMode property specifies the ambient user mode of the container.

put_AllowContextMenu

The AllowContextMenu property specifies whether the hosted control is allowed to display its own context menu.

put_AllowShowUI

The AllowShowUI property specifies whether the hosted control is allowed to display its own user interface.

put_AllowWindowlessActivation

The AllowWindowlessActivation property specifies whether the container will allow windowless activation.

put_BackColor

The BackColor property specifies the ambient background color of the container.

put_DisplayAsDefault

DisplayAsDefault is an ambient property that allows a control to find out if it is the default control.

put_DocHostDoubleClickFlags

The DocHostDoubleClickFlags property specifies the operation that should take place in response to a double-click.

put_DocHostFlags

The DocHostFlags property specifies the user interface capabilities of the host object.

put_Font

The Font property specifies the ambient font of the container.

put_ForeColor

The ForeColor property specifies the ambient foreground color of the container.

put_LocaleID

The LocaleID property specifies the ambient locale ID of the container.

put_MessageReflect

The MessageReflect ambient property specifies whether the container will reflect messages to the hosted control.

put_OptionKeyPath

The OptionKeyPath property specifies the registry key path to user settings.

put_UserMode

The UserMode property specifies the ambient user mode of the container.

Remarks

This interface is exposed by ATL's ActiveX control hosting objects. Call the methods on this interface to set the ambient properties available to the hosted control or to specify other aspects of the container's behavior. To supplement the properties provided by IAxWinAmbientDispatch, use IAxWinAmbientDispatchEx.

AXHost will try to load type information about IAxWinAmbientDispatch and IAxWinAmbientDispatchEx from the typelib that contains the code.

If you are linking to ATL90.dll, AXHost will load the type information from the typelib in the DLL.

See Hosting ActiveX Controls Using ATL AXHost for more details.

Requirements

The definition of this interface is available in a number of forms, as shown in the table below.

Definition Type

File

IDL

atliface.idl

Type Library

ATL.dll

C++

atliface.h (also included in ATLBase.h)

See Also

Reference

IAxWinAmbientDispatchEx Interface

IAxWinHostWindow Interface

CAxWindow::QueryHost

AtlAxGetHost