IAxWinAmbientDispatch Arabirimi

Bu arabirim, barındırılan denetimin veya kapsayıcının özelliklerini belirtmek için yöntemler sağlar.

Önemli

Bu sınıf ve üyeleri Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz.

Sözdizimi

interface IAxWinAmbientDispatch : IDispatch

Üyeler

Yöntemler

Ad	Tanım
get_AllowContextMenu	özelliği, AllowContextMenu barındırılan denetimin kendi bağlam menüsünü görüntülemesine izin verilip verilmeyeceğini belirtir.
get_AllowShowUI	özelliği, AllowShowUI barındırılan denetimin kendi kullanıcı arabirimini görüntülemesine izin verilip verilmeyeceğini belirtir.
get_AllowWindowlessActivation	özelliği, AllowWindowlessActivation kapsayıcının penceresiz etkinleştirmeye izin verip vermeyeceğini belirtir.
get_BackColor	özelliği kapsayıcının BackColor ortam arka plan rengini belirtir.
get_DisplayAsDefault	DisplayAsDefault , bir denetimin varsayılan denetim olup olmadığını öğrenmesine olanak tanıyan bir ortam özelliğidir.
get_DocHostDoubleClickFlags	özelliği, DocHostDoubleClickFlags çift tıklamaya yanıt olarak gerçekleşmesi gereken işlemi belirtir.
get_DocHostFlags	özelliği, DocHostFlags konak nesnesinin kullanıcı arabirimi özelliklerini belirtir.
get_Font	Font özelliği kapsayıcının ortam yazı tipini belirtir.
get_ForeColor	özelliği kapsayıcının ForeColor ortam ön plan rengini belirtir.
get_LocaleID	LocaleID özelliği kapsayıcının ortam yerel ayarı kimliğini belirtir.
get_MessageDüşünceler	MessageReflect ambient özelliği kapsayıcının iletileri barındırılan denetime yansıtıp yansıtmayacağını belirtir.
get_OptionKeyPath	OptionKeyPath özelliği, kullanıcı ayarlarının kayıt defteri anahtarı yolunu belirtir.
get_ShowGrabHandles	ortam ShowGrabHandles özelliği, denetimin tutma tutamaçlarıyla kendisini çizmesi gerekip gerekmediğini öğrenmesine olanak tanır.
get_ShowHatching	ortam ShowHatching özelliği, denetimin kendisini taranmış olarak çizmesi gerekip gerekmediğini öğrenmesine olanak tanır.
get_UserMode	UserMode özelliği kapsayıcının ortam kullanıcı modunu belirtir.
put_AllowContextMenu	özelliği, AllowContextMenu barındırılan denetimin kendi bağlam menüsünü görüntülemesine izin verilip verilmeyeceğini belirtir.
put_AllowShowUI	özelliği, AllowShowUI barındırılan denetimin kendi kullanıcı arabirimini görüntülemesine izin verilip verilmeyeceğini belirtir.
put_AllowWindowlessActivation	özelliği, AllowWindowlessActivation kapsayıcının penceresiz etkinleştirmeye izin verip vermeyeceğini belirtir.
put_BackColor	özelliği kapsayıcının BackColor ortam arka plan rengini belirtir.
put_DisplayAsDefault	DisplayAsDefault , bir denetimin varsayılan denetim olup olmadığını öğrenmesine olanak tanıyan bir ortam özelliğidir.
put_DocHostDoubleClickFlags	özelliği, DocHostDoubleClickFlags çift tıklamaya yanıt olarak gerçekleşmesi gereken işlemi belirtir.
put_DocHostFlags	özelliği, DocHostFlags konak nesnesinin kullanıcı arabirimi özelliklerini belirtir.
put_Font	Font özelliği kapsayıcının ortam yazı tipini belirtir.
put_ForeColor	özelliği kapsayıcının ForeColor ortam ön plan rengini belirtir.
put_LocaleID	LocaleID özelliği kapsayıcının ortam yerel ayarı kimliğini belirtir.
put_MessageDüşünceler	MessageReflect ambient özelliği kapsayıcının iletileri barındırılan denetime yansıtıp yansıtmayacağını belirtir.
put_OptionKeyPath	OptionKeyPath özelliği, kullanıcı ayarlarının kayıt defteri anahtarı yolunu belirtir.
put_UserMode	UserMode özelliği kapsayıcının ortam kullanıcı modunu belirtir.

Açıklamalar

Bu arabirim, ATL'nin ActiveX denetimi barındırma nesneleri tarafından kullanıma sunulur. Barındırılan denetimin kullanabileceği ortam özelliklerini ayarlamak veya kapsayıcının davranışının diğer yönlerini belirtmek için bu arabirimdeki yöntemleri çağırın. tarafından IAxWinAmbientDispatchsağlanan özellikleri desteklemek için IAxWinAmbientDispatchEx kullanın.

AxHost , kodu içeren typelib ile ilgili IAxWinAmbientDispatch ve IAxWinAmbientDispatchEx türü bilgilerini yüklemeyi dener.

ATL90.dll dosyasına bağlanıyorsanız AXHost, DLL'deki tür kitaplığından tür bilgilerini yükler.

Diğer ayrıntılar için bkz . ATL AXHost Kullanarak ActiveX Denetimlerini Barındırma.

Gereksinimler

Bu arabirimin tanımı, aşağıdaki tabloda gösterildiği gibi çeşitli formlarda kullanılabilir.

Tanım Türü	Dosya
IDL	atliface.idl
Tür Kitaplığı	ATL.dll
C++	atliface.h (ATLBase.h'de de bulunur)

IAxWinAmbientDispatch::get_AllowContextMenu

özelliği, AllowContextMenu barındırılan denetimin kendi bağlam menüsünü görüntülemesine izin verilip verilmeyeceğini belirtir.

STDMETHOD(get_AllowContextMenu)(VARIANT_BOOL* pbAllowContextMenu);

Parametreler

pbAllowContextMenu
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_TRUE kullanır.

IAxWinAmbientDispatch::get_AllowShowUI

özelliği, AllowShowUI barındırılan denetimin kendi kullanıcı arabirimini görüntülemesine izin verilip verilmeyeceğini belirtir.

STDMETHOD(get_AllowShowUI)(VARIANT_BOOL* pbAllowShowUI);

Parametreler

pbAllowShowUI
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_FALSE kullanır.

IAxWinAmbientDispatch::get_AllowWindowlessActivation

özelliği, AllowWindowlessActivation kapsayıcının penceresiz etkinleştirmeye izin verip vermeyeceğini belirtir.

STDMETHOD(get_AllowWindowlessActivation)(VARIANT_BOOL* pbAllowWindowless);

Parametreler

pbAllowWindowless
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_TRUE kullanır.

IAxWinAmbientDispatch::get_BackColor

özelliği kapsayıcının BackColor ortam arka plan rengini belirtir.

STDMETHOD(get_BackColor)(OLE_COLOR* pclrBackground);

Parametreler

pclrBackground
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak COLOR_BTNFACE veya COLOR_WINDOW kullanır (konak penceresinin üst öğesinin bir iletişim kutusu olup olmamasına bağlı olarak).

IAxWinAmbientDispatch::get_DisplayAsDefault

DisplayAsDefault , bir denetimin varsayılan denetim olup olmadığını öğrenmesine olanak tanıyan bir ortam özelliğidir.

STDMETHOD(get_DisplayAsDefault)(VARIANT_BOOL* pbDisplayAsDefault);

Parametreler

pbDisplayAsDefault
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_FALSE kullanır.

IAxWinAmbientDispatch::get_DocHostDoubleClickFlags

özelliği, DocHostDoubleClickFlags çift tıklamaya yanıt olarak gerçekleşmesi gereken işlemi belirtir.

STDMETHOD(get_DocHostDoubleClickFlags)(DWORD* pdwDocHostDoubleClickFlags);

Parametreler

pdwDocHostDoubleClickFlags
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak DOCHOSTUIDBLCLK_DEFAULT kullanır.

IAxWinAmbientDispatch::get_DocHostFlags

özelliği, DocHostFlags konak nesnesinin kullanıcı arabirimi özelliklerini belirtir.

STDMETHOD(get_DocHostFlags)(DWORD* pdwDocHostFlags);

Parametreler

pdwDocHostFlags
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak DOCHOSTUIFLAG_NO3DBORDER kullanır.

IAxWinAmbientDispatch::get_Font

Font özelliği kapsayıcının ortam yazı tipini belirtir.

STDMETHOD(get_Font)(IFontDisp** pFont);

Parametreler

pFont
[out] Bu özelliğin geçerli değerini almak için kullanılan arabirim IFontDisp işaretçisinin adresi.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak varsayılan GUI yazı tipini veya sistem yazı tipini kullanır.

IAxWinAmbientDispatch::get_ForeColor

özelliği kapsayıcının ForeColor ortam ön plan rengini belirtir.

STDMETHOD(get_ForeColor)(OLE_COLOR* pclrForeground);

Parametreler

pclrForeground
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak sistem penceresi metin rengini kullanır.

IAxWinAmbientDispatch::get_LocaleID

LocaleID özelliği kapsayıcının ortam yerel ayarı kimliğini belirtir.

STDMETHOD(get_LocaleID)(LCID* plcidLocaleID);

Parametreler

plcidLocaleID
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak kullanıcının varsayılan yerel ayarını kullanır.

Bu yöntemle, denetiminizin kullanıldığı programın LocaleID'sini( ortam localid'sini) bulabilirsiniz. LocaleID'yi bildiğinizde, yerel ayara özgü başlık, hata iletisi metni vb. bir kaynak dosyasından veya uydu DLL'den yüklemek için kod çağırabilirsiniz.

IAxWinAmbientDispatch::get_MessageDüşünceler

MessageReflect ambient özelliği kapsayıcının iletileri barındırılan denetime yansıtıp yansıtmayacağını belirtir.

STDMETHOD(get_MessageReflect)(VARIANT_BOOL* pbMessageReflect);

Parametreler

pbMessage Düşünceler
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_TRUE kullanır.

IAxWinAmbientDispatch::get_OptionKeyPath

OptionKeyPath özelliği, kullanıcı ayarlarının kayıt defteri anahtarı yolunu belirtir.

STDMETHOD(get_OptionKeyPath)(BSTR* pbstrOptionKeyPath);

Parametreler

pbstrOptionKeyPath
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.

İade Değeri

Standart bir HRESULT değeri.

IAxWinAmbientDispatch::get_ShowGrabHandles

ortam ShowGrabHandles özelliği, denetimin tutma tutamaçlarıyla kendisini çizmesi gerekip gerekmediğini öğrenmesine olanak tanır.

STDMETHOD(get_ShowGrabHandles)(VARIANT_BOOL* pbShowGrabHandles);

Parametreler

pbShowGrabHandles
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması her zaman bu özelliğin değeri olarak VARIANT_FALSE döndürür.

IAxWinAmbientDispatch::get_ShowHatching

ortam ShowHatching özelliği, denetimin kendisini taranmış olarak çizmesi gerekip gerekmediğini öğrenmesine olanak tanır.

STDMETHOD(get_ShowHatching)(VARIANT_BOOL* pbShowHatching);

Parametreler

pbShowHatching
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması her zaman bu özelliğin değeri olarak VARIANT_FALSE döndürür.

IAxWinAmbientDispatch::get_UserMode

UserMode özelliği kapsayıcının ortam kullanıcı modunu belirtir.

STDMETHOD(get_UserMode)(VARIANT_BOOL* pbUserMode);

Parametreler

pbUserMode
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_TRUE kullanır.

IAxWinAmbientDispatch::p ut_AllowContextMenu

özelliği, AllowContextMenu barındırılan denetimin kendi bağlam menüsünü görüntülemesine izin verilip verilmeyeceğini belirtir.

STDMETHOD(put_AllowContextMenu)(VARIANT_BOOL bAllowContextMenu);

Parametreler

bAllowContextMenu
[in] Bu özelliğin yeni değeri.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_TRUE kullanır.

IAxWinAmbientDispatch::p ut_AllowShowUI

özelliği, AllowShowUI barındırılan denetimin kendi kullanıcı arabirimini görüntülemesine izin verilip verilmeyeceğini belirtir.

STDMETHOD(put_AllowShowUI)(VARIANT_BOOL bAllowShowUI);

Parametreler

bAllowShowUI
[in] Bu özelliğin yeni değeri.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_FALSE kullanır.

IAxWinAmbientDispatch::p ut_AllowWindowlessActivation

özelliği, AllowWindowlessActivation kapsayıcının penceresiz etkinleştirmeye izin verip vermeyeceğini belirtir.

STDMETHOD(put_AllowWindowlessActivation)(VARIANT_BOOL bAllowWindowless);

Parametreler

bAllowWindowless
[in] Bu özelliğin yeni değeri.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_TRUE kullanır.

IAxWinAmbientDispatch::p ut_BackColor

özelliği kapsayıcının BackColor ortam arka plan rengini belirtir.

STDMETHOD(put_BackColor)(OLE_COLOR clrBackground);

Parametreler

clrBackground
[in] Bu özelliğin yeni değeri.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak COLOR_BTNFACE veya COLOR_WINDOW kullanır (konak penceresinin üst öğesinin bir iletişim kutusu olup olmamasına bağlı olarak).

IAxWinAmbientDispatch::p ut_DisplayAsDefault

DisplayAsDefault , bir denetimin varsayılan denetim olup olmadığını öğrenmesine olanak tanıyan bir ortam özelliğidir.

STDMETHOD(put_DisplayAsDefault)(VARIANT_BOOL bDisplayAsDefault);

Parametreler

bDisplayAsDefault
[in] Bu özelliğin yeni değeri.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_FALSE kullanır.

IAxWinAmbientDispatch::p ut_DocHostDoubleClickFlags

özelliği, DocHostDoubleClickFlags çift tıklamaya yanıt olarak gerçekleşmesi gereken işlemi belirtir.

STDMETHOD(put_DocHostDoubleClickFlags)(DWORD dwDocHostDoubleClickFlags);

Parametreler

dwDocHostDoubleClickFlags
[in] Bu özelliğin yeni değeri.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak DOCHOSTUIDBLCLK_DEFAULT kullanır.

IAxWinAmbientDispatch::p ut_DocHostFlags

özelliği, DocHostFlags konak nesnesinin kullanıcı arabirimi özelliklerini belirtir.

STDMETHOD(put_DocHostFlags)(DWORD dwDocHostFlags);

Parametreler

dwDocHostFlags
[in] Bu özelliğin yeni değeri.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak DOCHOSTUIFLAG_NO3DBORDER kullanır.

IAxWinAmbientDispatch::p ut_Font

Font özelliği kapsayıcının ortam yazı tipini belirtir.

STDMETHOD(put_Font)(IFontDisp* pFont);

Parametreler

pFont
[in] Bu özelliğin yeni değeri.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak varsayılan GUI yazı tipini veya sistem yazı tipini kullanır.

IAxWinAmbientDispatch::p ut_ForeColor

özelliği kapsayıcının ForeColor ortam ön plan rengini belirtir.

STDMETHOD(put_ForeColor)(OLE_COLOR clrForeground);

Parametreler

clrForeground
[in] Bu özelliğin yeni değeri.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak sistem penceresi metin rengini kullanır.

IAxWinAmbientDispatch::p ut_LocaleID

LocaleID özelliği kapsayıcının ortam yerel ayarı kimliğini belirtir.

STDMETHOD(put_LocaleID)(LCID lcidLocaleID);

Parametreler

lcidLocaleID
[in] Bu özelliğin yeni değeri.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak kullanıcının varsayılan yerel ayarını kullanır.

IAxWinAmbientDispatch::p ut_Message Düşünceler

MessageReflect ambient özelliği kapsayıcının iletileri barındırılan denetime yansıtıp yansıtmayacağını belirtir.

STDMETHOD(put_MessageReflect)(VARIANT_BOOL bMessageReflect);

Parametreler

bMessage Düşünceler
[in] Bu özelliğin yeni değeri.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_TRUE kullanır.

IAxWinAmbientDispatch::p ut_OptionKeyPath

OptionKeyPath özelliği, kullanıcı ayarlarının kayıt defteri anahtarı yolunu belirtir.

STDMETHOD(put_OptionKeyPath)(BSTR bstrOptionKeyPath);

Parametreler

bstrOptionKeyPath
[in] Bu özelliğin yeni değeri.

İade Değeri

Standart bir HRESULT değeri.

IAxWinAmbientDispatch::p ut_UserMode

UserMode özelliği kapsayıcının ortam kullanıcı modunu belirtir.

STDMETHOD(put_UserMode)(VARIANT_BOOL bUserMode);

Parametreler

bUserMode
[in] Bu özelliğin yeni değeri.

İade Değeri

Standart bir HRESULT değeri.

Açıklamalar

ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_TRUE kullanır.

Ayrıca bkz.

IAxWinAmbientDispatchEx Arabirimi
IAxWinHostWindow Arabirimi
CAxWindow::QueryHost
AtlAxGetHost