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.
interface IAxWinAmbientDispatch : IDispatch
Veri Akışı Adı | Açıklama |
---|---|
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_MessageReflect | 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_MessageReflect | 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. |
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 IAxWinAmbientDispatch
sağ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 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.
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) |
ö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);
pbAllowContextMenu
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_TRUE kullanır.
ö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);
pbAllowShowUI
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_FALSE kullanır.
özelliği, AllowWindowlessActivation
kapsayıcının penceresiz etkinleştirmeye izin verip vermeyeceğini belirtir.
STDMETHOD(get_AllowWindowlessActivation)(VARIANT_BOOL* pbAllowWindowless);
pbAllowWindowless
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_TRUE kullanır.
özelliği kapsayıcının BackColor
ortam arka plan rengini belirtir.
STDMETHOD(get_BackColor)(OLE_COLOR* pclrBackground);
pclrBackground
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.
Standart bir HRESULT değeri.
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).
DisplayAsDefault
, bir denetimin varsayılan denetim olup olmadığını öğrenmesine olanak tanıyan bir ortam özelliğidir.
STDMETHOD(get_DisplayAsDefault)(VARIANT_BOOL* pbDisplayAsDefault);
pbDisplayAsDefault
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_FALSE kullanır.
özelliği, DocHostDoubleClickFlags
çift tıklamaya yanıt olarak gerçekleşmesi gereken işlemi belirtir.
STDMETHOD(get_DocHostDoubleClickFlags)(DWORD* pdwDocHostDoubleClickFlags);
pdwDocHostDoubleClickFlags
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak DOCHOSTUIDBLCLK_DEFAULT kullanır.
özelliği, DocHostFlags
konak nesnesinin kullanıcı arabirimi özelliklerini belirtir.
STDMETHOD(get_DocHostFlags)(DWORD* pdwDocHostFlags);
pdwDocHostFlags
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak DOCHOSTUIFLAG_NO3DBORDER kullanır.
Font
özelliği kapsayıcının ortam yazı tipini belirtir.
STDMETHOD(get_Font)(IFontDisp** pFont);
pFont
[out] Bu özelliğin geçerli değerini almak için kullanılan arabirim IFontDisp
işaretçisinin adresi.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak varsayılan GUI yazı tipini veya sistem yazı tipini kullanır.
özelliği kapsayıcının ForeColor
ortam ön plan rengini belirtir.
STDMETHOD(get_ForeColor)(OLE_COLOR* pclrForeground);
pclrForeground
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak sistem penceresi metin rengini kullanır.
LocaleID
özelliği kapsayıcının ortam yerel ayarı kimliğini belirtir.
STDMETHOD(get_LocaleID)(LCID* plcidLocaleID);
plcidLocaleID
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.
Standart bir HRESULT değeri.
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ü açıklamalı alt yazıları, hata iletisi metnini vb. bir kaynak dosyasından veya uydu DLL'den yüklemek için kodu çağırabilirsiniz.
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);
pbMessageReflect
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_TRUE kullanır.
OptionKeyPath
özelliği, kullanıcı ayarlarının kayıt defteri anahtarı yolunu belirtir.
STDMETHOD(get_OptionKeyPath)(BSTR* pbstrOptionKeyPath);
pbstrOptionKeyPath
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.
Standart bir HRESULT değeri.
ortam ShowGrabHandles
özelliği, denetimin tutma tutamaçlarıyla kendisini çizmesi gerekip gerekmediğini öğrenmesine olanak tanır.
STDMETHOD(get_ShowGrabHandles)(VARIANT_BOOL* pbShowGrabHandles);
pbShowGrabHandles
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması her zaman bu özelliğin değeri olarak VARIANT_FALSE döndürür.
ortam ShowHatching
özelliği, denetimin kendisini taranmış olarak çizmesi gerekip gerekmediğini öğrenmesine olanak tanır.
STDMETHOD(get_ShowHatching)(VARIANT_BOOL* pbShowHatching);
pbShowHatching
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması her zaman bu özelliğin değeri olarak VARIANT_FALSE döndürür.
UserMode
özelliği kapsayıcının ortam kullanıcı modunu belirtir.
STDMETHOD(get_UserMode)(VARIANT_BOOL* pbUserMode);
pbUserMode
[out] Bu özelliğin geçerli değerini alacak değişkenin adresi.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_TRUE kullanır.
ö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);
bAllowContextMenu
[in] Bu özelliğin yeni değeri.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_TRUE kullanır.
ö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);
bAllowShowUI
[in] Bu özelliğin yeni değeri.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_FALSE kullanır.
özelliği, AllowWindowlessActivation
kapsayıcının penceresiz etkinleştirmeye izin verip vermeyeceğini belirtir.
STDMETHOD(put_AllowWindowlessActivation)(VARIANT_BOOL bAllowWindowless);
bAllowWindowless
[in] Bu özelliğin yeni değeri.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_TRUE kullanır.
özelliği kapsayıcının BackColor
ortam arka plan rengini belirtir.
STDMETHOD(put_BackColor)(OLE_COLOR clrBackground);
clrBackground
[in] Bu özelliğin yeni değeri.
Standart bir HRESULT değeri.
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).
DisplayAsDefault
, bir denetimin varsayılan denetim olup olmadığını öğrenmesine olanak tanıyan bir ortam özelliğidir.
STDMETHOD(put_DisplayAsDefault)(VARIANT_BOOL bDisplayAsDefault);
bDisplayAsDefault
[in] Bu özelliğin yeni değeri.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_FALSE kullanır.
özelliği, DocHostDoubleClickFlags
çift tıklamaya yanıt olarak gerçekleşmesi gereken işlemi belirtir.
STDMETHOD(put_DocHostDoubleClickFlags)(DWORD dwDocHostDoubleClickFlags);
dwDocHostDoubleClickFlags
[in] Bu özelliğin yeni değeri.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak DOCHOSTUIDBLCLK_DEFAULT kullanır.
özelliği, DocHostFlags
konak nesnesinin kullanıcı arabirimi özelliklerini belirtir.
STDMETHOD(put_DocHostFlags)(DWORD dwDocHostFlags);
dwDocHostFlags
[in] Bu özelliğin yeni değeri.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak DOCHOSTUIFLAG_NO3DBORDER kullanır.
Font
özelliği kapsayıcının ortam yazı tipini belirtir.
STDMETHOD(put_Font)(IFontDisp* pFont);
pFont
[in] Bu özelliğin yeni değeri.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak varsayılan GUI yazı tipini veya sistem yazı tipini kullanır.
özelliği kapsayıcının ForeColor
ortam ön plan rengini belirtir.
STDMETHOD(put_ForeColor)(OLE_COLOR clrForeground);
clrForeground
[in] Bu özelliğin yeni değeri.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak sistem penceresi metin rengini kullanır.
LocaleID
özelliği kapsayıcının ortam yerel ayarı kimliğini belirtir.
STDMETHOD(put_LocaleID)(LCID lcidLocaleID);
lcidLocaleID
[in] Bu özelliğin yeni değeri.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak kullanıcının varsayılan yerel ayarını kullanır.
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);
bMessageReflect
[in] Bu özelliğin yeni değeri.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_TRUE kullanır.
OptionKeyPath
özelliği, kullanıcı ayarlarının kayıt defteri anahtarı yolunu belirtir.
STDMETHOD(put_OptionKeyPath)(BSTR bstrOptionKeyPath);
bstrOptionKeyPath
[in] Bu özelliğin yeni değeri.
Standart bir HRESULT değeri.
UserMode
özelliği kapsayıcının ortam kullanıcı modunu belirtir.
STDMETHOD(put_UserMode)(VARIANT_BOOL bUserMode);
bUserMode
[in] Bu özelliğin yeni değeri.
Standart bir HRESULT değeri.
ATL konak nesnesi uygulaması, bu özelliğin varsayılan değeri olarak VARIANT_TRUE kullanır.
IAxWinAmbientDispatchEx Arabirimi
IAxWinHostWindow Arabirimi
CAxWindow::QueryHost
AtlAxGetHost