IAxWinAmbientDispatch 인터페이스

이 인터페이스는 호스트된 컨트롤 또는 컨테이너의 특성을 지정하는 메서드를 제공합니다.

Important

이 클래스와 해당 멤버는 Windows 런타임에서 실행되는 애플리케이션에서 사용할 수 없습니다.

구문

interface IAxWinAmbientDispatch : IDispatch

멤버

메서드

속성	설명
get_AllowContextMenu	이 속성은 AllowContextMenu 호스트된 컨트롤이 자체 상황에 맞는 메뉴를 표시할 수 있는지 여부를 지정합니다.
get_AllowShowUI	이 속성은 AllowShowUI 호스트된 컨트롤이 자체 사용자 인터페이스를 표시할 수 있는지 여부를 지정합니다.
get_AllowWindowlessActivation	이 속성은 AllowWindowlessActivation 컨테이너가 창 없는 활성화를 허용할지 여부를 지정합니다.
get_BackColor	이 속성은 BackColor 컨테이너의 앰비언트 배경색을 지정합니다.
get_DisplayAsDefault	DisplayAsDefault 는 컨트롤이 기본 컨트롤인지 확인할 수 있는 앰비언트 속성입니다.
get_DocHostDoubleClickFlags	이 속성은 DocHostDoubleClickFlags 두 번 클릭에 대한 응답으로 수행해야 하는 작업을 지정합니다.
get_DocHostFlags	이 속성은 DocHostFlags 호스트 개체의 사용자 인터페이스 기능을 지정합니다.
get_Font	이 속성은 Font 컨테이너의 앰비언트 글꼴을 지정합니다.
get_ForeColor	이 속성은 ForeColor 컨테이너의 앰비언트 전경색을 지정합니다.
get_LocaleID	이 속성은 LocaleID 컨테이너의 앰비언트 로캘 ID를 지정합니다.
get_MessageReflect	앰비언트 속성은 MessageReflect 컨테이너가 호스트된 컨트롤에 메시지를 반영할지 여부를 지정합니다.
get_OptionKeyPath	이 속성은 OptionKeyPath 사용자 설정에 대한 레지스트리 키 경로를 지정합니다.
get_ShowGrabHandles	ShowGrabHandles 앰비언트 속성을 사용하면 컨트롤이 잡기 핸들로 직접 그려야 하는지 확인할 수 있습니다.
get_ShowHatching	ShowHatching 앰비언트 속성을 사용하면 컨트롤이 자체 빗살 무늬로 그려야 하는지 확인할 수 있습니다.
get_UserMode	이 속성은 UserMode 컨테이너의 앰비언트 사용자 모드를 지정합니다.
put_AllowContextMenu	이 속성은 AllowContextMenu 호스트된 컨트롤이 자체 상황에 맞는 메뉴를 표시할 수 있는지 여부를 지정합니다.
put_AllowShowUI	이 속성은 AllowShowUI 호스트된 컨트롤이 자체 사용자 인터페이스를 표시할 수 있는지 여부를 지정합니다.
put_AllowWindowlessActivation	이 속성은 AllowWindowlessActivation 컨테이너가 창 없는 활성화를 허용할지 여부를 지정합니다.
put_BackColor	이 속성은 BackColor 컨테이너의 앰비언트 배경색을 지정합니다.
put_DisplayAsDefault	DisplayAsDefault 는 컨트롤이 기본 컨트롤인지 확인할 수 있는 앰비언트 속성입니다.
put_DocHostDoubleClickFlags	이 속성은 DocHostDoubleClickFlags 두 번 클릭에 대한 응답으로 수행해야 하는 작업을 지정합니다.
put_DocHostFlags	이 속성은 DocHostFlags 호스트 개체의 사용자 인터페이스 기능을 지정합니다.
put_Font	이 속성은 Font 컨테이너의 앰비언트 글꼴을 지정합니다.
put_ForeColor	이 속성은 ForeColor 컨테이너의 앰비언트 전경색을 지정합니다.
put_LocaleID	이 속성은 LocaleID 컨테이너의 앰비언트 로캘 ID를 지정합니다.
put_MessageReflect	앰비언트 속성은 MessageReflect 컨테이너가 호스트된 컨트롤에 메시지를 반영할지 여부를 지정합니다.
put_OptionKeyPath	이 속성은 OptionKeyPath 사용자 설정에 대한 레지스트리 키 경로를 지정합니다.
put_UserMode	이 속성은 UserMode 컨테이너의 앰비언트 사용자 모드를 지정합니다.

설명

이 인터페이스는 ATL의 ActiveX 컨트롤 호스팅 개체에 의해 노출됩니다. 호스트된 컨트롤에 사용할 수 있는 앰비언트 속성을 설정하거나 컨테이너 동작의 다른 측면을 지정하려면 이 인터페이스의 메서드를 호출합니다. 제공된 IAxWinAmbientDispatch속성을 보완하려면 IAxWinAmbientDispatchEx를 사용합니다.

AxHost 는 코드가 포함된 typelib에 대한 IAxWinAmbientDispatch IAxWinAmbientDispatchEx 형식 정보를 로드하려고 합니다.

ATL90.dll 연결하는 경우 AXHost 는 DLL의 typelib에서 형식 정보를 로드합니다.

자세한 내용은 ATL AXHost를 사용하여 ActiveX 컨트롤 호스팅을 참조하세요.

요구 사항

이 인터페이스의 정의는 아래 표와 같이 다양한 형식으로 사용할 수 있습니다.

정의 형식	파일
IDL	atliface.idl
형식 라이브러리	ATL.dll
C++	atliface.h(ATLBase.h에도 포함)

IAxWinAmbientDispatch::get_AllowContextMenu

이 속성은 AllowContextMenu 호스트된 컨트롤이 자체 상황에 맞는 메뉴를 표시할 수 있는지 여부를 지정합니다.

STDMETHOD(get_AllowContextMenu)(VARIANT_BOOL* pbAllowContextMenu);

매개 변수

pbAllowContextMenu
[out] 이 속성의 현재 값을 받을 변수의 주소입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 이 속성의 기본값으로 VARIANT_TRUE 사용합니다.

IAxWinAmbientDispatch::get_AllowShowUI

이 속성은 AllowShowUI 호스트된 컨트롤이 자체 사용자 인터페이스를 표시할 수 있는지 여부를 지정합니다.

STDMETHOD(get_AllowShowUI)(VARIANT_BOOL* pbAllowShowUI);

매개 변수

pbAllowShowUI
[out] 이 속성의 현재 값을 받을 변수의 주소입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 이 속성의 기본값으로 VARIANT_FALSE 사용합니다.

IAxWinAmbientDispatch::get_AllowWindowlessActivation

이 속성은 AllowWindowlessActivation 컨테이너가 창 없는 활성화를 허용할지 여부를 지정합니다.

STDMETHOD(get_AllowWindowlessActivation)(VARIANT_BOOL* pbAllowWindowless);

매개 변수

pbAllowWindowless
[out] 이 속성의 현재 값을 받을 변수의 주소입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 이 속성의 기본값으로 VARIANT_TRUE 사용합니다.

IAxWinAmbientDispatch::get_BackColor

이 속성은 BackColor 컨테이너의 앰비언트 배경색을 지정합니다.

STDMETHOD(get_BackColor)(OLE_COLOR* pclrBackground);

매개 변수

pclrBackground
[out] 이 속성의 현재 값을 받을 변수의 주소입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 COLOR_BTNFACE 또는 COLOR_WINDOW 이 속성의 기본값으로 사용합니다(호스트 창의 부모가 대화 상자인지 여부에 따라 다름).

IAxWinAmbientDispatch::get_DisplayAsDefault

DisplayAsDefault 는 컨트롤이 기본 컨트롤인지 확인할 수 있는 앰비언트 속성입니다.

STDMETHOD(get_DisplayAsDefault)(VARIANT_BOOL* pbDisplayAsDefault);

매개 변수

pbDisplayAsDefault
[out] 이 속성의 현재 값을 받을 변수의 주소입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 이 속성의 기본값으로 VARIANT_FALSE 사용합니다.

IAxWinAmbientDispatch::get_DocHostDoubleClickFlags

이 속성은 DocHostDoubleClickFlags 두 번 클릭에 대한 응답으로 수행해야 하는 작업을 지정합니다.

STDMETHOD(get_DocHostDoubleClickFlags)(DWORD* pdwDocHostDoubleClickFlags);

매개 변수

pdwDocHostDoubleClickFlags
[out] 이 속성의 현재 값을 받을 변수의 주소입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 이 속성의 기본값으로 DOCHOSTUIDBLCLK_DEFAULT 사용합니다.

IAxWinAmbientDispatch::get_DocHostFlags

이 속성은 DocHostFlags 호스트 개체의 사용자 인터페이스 기능을 지정합니다.

STDMETHOD(get_DocHostFlags)(DWORD* pdwDocHostFlags);

매개 변수

pdwDocHostFlags
[out] 이 속성의 현재 값을 받을 변수의 주소입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 이 속성의 기본값으로 DOCHOSTUIFLAG_NO3DBORDER 사용합니다.

IAxWinAmbientDispatch::get_Font

이 속성은 Font 컨테이너의 앰비언트 글꼴을 지정합니다.

STDMETHOD(get_Font)(IFontDisp** pFont);

매개 변수

pFont
[out] 이 속성의 IFontDisp 현재 값을 받는 데 사용되는 인터페이스 포인터의 주소입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 기본 GUI 글꼴 또는 시스템 글꼴을 이 속성의 기본값으로 사용합니다.

IAxWinAmbientDispatch::get_ForeColor

이 속성은 ForeColor 컨테이너의 앰비언트 전경색을 지정합니다.

STDMETHOD(get_ForeColor)(OLE_COLOR* pclrForeground);

매개 변수

pclrForeground
[out] 이 속성의 현재 값을 받을 변수의 주소입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 시스템 창 텍스트 색을 이 속성의 기본값으로 사용합니다.

IAxWinAmbientDispatch::get_LocaleID

이 속성은 LocaleID 컨테이너의 앰비언트 로캘 ID를 지정합니다.

STDMETHOD(get_LocaleID)(LCID* plcidLocaleID);

매개 변수

plcidLocaleID
[out] 이 속성의 현재 값을 받을 변수의 주소입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 사용자의 기본 로캘을 이 속성의 기본값으로 사용합니다.

이 메서드를 사용하면 컨트롤이 사용되는 프로그램의 LocaleID인 Ambient LocalID를 검색할 수 있습니다. LocaleID를 알게 되면 코드를 호출하여 리소스 파일 또는 위성 DLL에서 로캘별 캡션, 오류 메시지 텍스트 등을 로드할 수 있습니다.

IAxWinAmbientDispatch::get_MessageReflect

앰비언트 속성은 MessageReflect 컨테이너가 호스트된 컨트롤에 메시지를 반영할지 여부를 지정합니다.

STDMETHOD(get_MessageReflect)(VARIANT_BOOL* pbMessageReflect);

매개 변수

pbMessageReflect
[out] 이 속성의 현재 값을 받을 변수의 주소입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 이 속성의 기본값으로 VARIANT_TRUE 사용합니다.

IAxWinAmbientDispatch::get_OptionKeyPath

이 속성은 OptionKeyPath 사용자 설정에 대한 레지스트리 키 경로를 지정합니다.

STDMETHOD(get_OptionKeyPath)(BSTR* pbstrOptionKeyPath);

매개 변수

pbstrOptionKeyPath
[out] 이 속성의 현재 값을 받을 변수의 주소입니다.

Return Value

표준 HRESULT 값입니다.

IAxWinAmbientDispatch::get_ShowGrabHandles

ShowGrabHandles 앰비언트 속성을 사용하면 컨트롤이 잡기 핸들로 직접 그려야 하는지 확인할 수 있습니다.

STDMETHOD(get_ShowGrabHandles)(VARIANT_BOOL* pbShowGrabHandles);

매개 변수

pbShowGrabHandles
[out] 이 속성의 현재 값을 받을 변수의 주소입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 항상 이 속성의 값으로 VARIANT_FALSE 반환합니다.

IAxWinAmbientDispatch::get_ShowHatching

ShowHatching 앰비언트 속성을 사용하면 컨트롤이 자체 빗살 무늬로 그려야 하는지 확인할 수 있습니다.

STDMETHOD(get_ShowHatching)(VARIANT_BOOL* pbShowHatching);

매개 변수

pbShowHatching
[out] 이 속성의 현재 값을 받을 변수의 주소입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 항상 이 속성의 값으로 VARIANT_FALSE 반환합니다.

IAxWinAmbientDispatch::get_UserMode

이 속성은 UserMode 컨테이너의 앰비언트 사용자 모드를 지정합니다.

STDMETHOD(get_UserMode)(VARIANT_BOOL* pbUserMode);

매개 변수

pbUserMode
[out] 이 속성의 현재 값을 받을 변수의 주소입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 이 속성의 기본값으로 VARIANT_TRUE 사용합니다.

IAxWinAmbientDispatch::p ut_AllowContextMenu

이 속성은 AllowContextMenu 호스트된 컨트롤이 자체 상황에 맞는 메뉴를 표시할 수 있는지 여부를 지정합니다.

STDMETHOD(put_AllowContextMenu)(VARIANT_BOOL bAllowContextMenu);

매개 변수

bAllowContextMenu
[in] 이 속성의 새 값입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 이 속성의 기본값으로 VARIANT_TRUE 사용합니다.

IAxWinAmbientDispatch::p ut_AllowShowUI

이 속성은 AllowShowUI 호스트된 컨트롤이 자체 사용자 인터페이스를 표시할 수 있는지 여부를 지정합니다.

STDMETHOD(put_AllowShowUI)(VARIANT_BOOL bAllowShowUI);

매개 변수

bAllowShowUI
[in] 이 속성의 새 값입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 이 속성의 기본값으로 VARIANT_FALSE 사용합니다.

IAxWinAmbientDispatch::p ut_AllowWindowlessActivation

이 속성은 AllowWindowlessActivation 컨테이너가 창 없는 활성화를 허용할지 여부를 지정합니다.

STDMETHOD(put_AllowWindowlessActivation)(VARIANT_BOOL bAllowWindowless);

매개 변수

bAllowWindowless
[in] 이 속성의 새 값입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 이 속성의 기본값으로 VARIANT_TRUE 사용합니다.

IAxWinAmbientDispatch::p ut_BackColor

이 속성은 BackColor 컨테이너의 앰비언트 배경색을 지정합니다.

STDMETHOD(put_BackColor)(OLE_COLOR clrBackground);

매개 변수

clrBackground
[in] 이 속성의 새 값입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 COLOR_BTNFACE 또는 COLOR_WINDOW 이 속성의 기본값으로 사용합니다(호스트 창의 부모가 대화 상자인지 여부에 따라 다름).

IAxWinAmbientDispatch::p ut_DisplayAsDefault

DisplayAsDefault 는 컨트롤이 기본 컨트롤인지 확인할 수 있는 앰비언트 속성입니다.

STDMETHOD(put_DisplayAsDefault)(VARIANT_BOOL bDisplayAsDefault);

매개 변수

bDisplayAsDefault
[in] 이 속성의 새 값입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 이 속성의 기본값으로 VARIANT_FALSE 사용합니다.

IAxWinAmbientDispatch::p ut_DocHostDoubleClickFlags

이 속성은 DocHostDoubleClickFlags 두 번 클릭에 대한 응답으로 수행해야 하는 작업을 지정합니다.

STDMETHOD(put_DocHostDoubleClickFlags)(DWORD dwDocHostDoubleClickFlags);

매개 변수

dwDocHostDoubleClickFlags
[in] 이 속성의 새 값입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 이 속성의 기본값으로 DOCHOSTUIDBLCLK_DEFAULT 사용합니다.

IAxWinAmbientDispatch::p ut_DocHostFlags

이 속성은 DocHostFlags 호스트 개체의 사용자 인터페이스 기능을 지정합니다.

STDMETHOD(put_DocHostFlags)(DWORD dwDocHostFlags);

매개 변수

dwDocHostFlags
[in] 이 속성의 새 값입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 이 속성의 기본값으로 DOCHOSTUIFLAG_NO3DBORDER 사용합니다.

IAxWinAmbientDispatch::p ut_Font

이 속성은 Font 컨테이너의 앰비언트 글꼴을 지정합니다.

STDMETHOD(put_Font)(IFontDisp* pFont);

매개 변수

pFont
[in] 이 속성의 새 값입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 기본 GUI 글꼴 또는 시스템 글꼴을 이 속성의 기본값으로 사용합니다.

IAxWinAmbientDispatch::p ut_ForeColor

이 속성은 ForeColor 컨테이너의 앰비언트 전경색을 지정합니다.

STDMETHOD(put_ForeColor)(OLE_COLOR clrForeground);

매개 변수

clrForeground
[in] 이 속성의 새 값입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 시스템 창 텍스트 색을 이 속성의 기본값으로 사용합니다.

IAxWinAmbientDispatch::p ut_LocaleID

이 속성은 LocaleID 컨테이너의 앰비언트 로캘 ID를 지정합니다.

STDMETHOD(put_LocaleID)(LCID lcidLocaleID);

매개 변수

lcidLocaleID
[in] 이 속성의 새 값입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 사용자의 기본 로캘을 이 속성의 기본값으로 사용합니다.

IAxWinAmbientDispatch::p ut_MessageReflect

앰비언트 속성은 MessageReflect 컨테이너가 호스트된 컨트롤에 메시지를 반영할지 여부를 지정합니다.

STDMETHOD(put_MessageReflect)(VARIANT_BOOL bMessageReflect);

매개 변수

bMessageReflect
[in] 이 속성의 새 값입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 이 속성의 기본값으로 VARIANT_TRUE 사용합니다.

IAxWinAmbientDispatch::p ut_OptionKeyPath

이 속성은 OptionKeyPath 사용자 설정에 대한 레지스트리 키 경로를 지정합니다.

STDMETHOD(put_OptionKeyPath)(BSTR bstrOptionKeyPath);

매개 변수

bstrOptionKeyPath
[in] 이 속성의 새 값입니다.

Return Value

표준 HRESULT 값입니다.

IAxWinAmbientDispatch::p ut_UserMode

이 속성은 UserMode 컨테이너의 앰비언트 사용자 모드를 지정합니다.

STDMETHOD(put_UserMode)(VARIANT_BOOL bUserMode);

매개 변수

bUserMode
[in] 이 속성의 새 값입니다.

Return Value

표준 HRESULT 값입니다.

설명

ATL 호스트 개체 구현은 이 속성의 기본값으로 VARIANT_TRUE 사용합니다.

참고 항목

IAxWinAmbientDispatchEx 인터페이스
IAxWinHostWindow 인터페이스
CAxWindow::QueryHost
AtlAxGetHost