IAtlMemMgr Sınıfı
Bu sınıf bir bellek yöneticisi arabirimini temsil eder.
Sözdizimi
__interface __declspec(uuid("654F7EF5-CFDF-4df9-A450-6C6A13C622C0")) IAtlMemMgr
Üyeler
Yöntemler
Ad | Tanım |
---|---|
Ayırmak | Bir bellek bloğu ayırmak için bu yöntemi çağırın. |
Ücretsiz | Bellek bloğunu boşaltmak için bu yöntemi çağırın. |
GetSize | Ayrılmış bellek bloğunun boyutunu almak için bu yöntemi çağırın. |
Yeniden ayırma | Bir bellek bloğunu yeniden dağıtmak için bu yöntemi çağırın. |
Açıklamalar
Bu arabirim CComHeap, CCRTHeap, CLocalHeap, CGlobalHeap veya CWin32Heap tarafından uygulanır.
Dekont
Yerel ve genel yığın işlevleri diğer bellek yönetimi işlevlerine göre daha yavaştır ve o kadar çok özellik sağlamaz. Bu nedenle, yeni uygulamalar yığın işlevlerini kullanmalıdır. Bunlar CWin32Heap sınıfında kullanılabilir.
Örnek
// Demonstrate IAtlMemMgr using the five possible
// memory function implementation classes.
HRESULT MemoryManagerDemonstration(IAtlMemMgr& MemoryManager) throw()
{
// The IAtlMemMgr interface guarantees not to throw exceptions
// so we can make the same guarantee for this function
// without adding exception handling code.
// A variable which will point to some allocated memory.
void* pMemory = NULL;
const size_t BytesInChunk = 1024;
// Allocate a chunk of memory
pMemory = MemoryManager.Allocate(BytesInChunk);
// Confirm the validity of the allocated memory
if (pMemory == NULL)
return E_OUTOFMEMORY;
// Confirm the size of the allocated memory
ATLASSERT(MemoryManager.GetSize(pMemory) == BytesInChunk);
// Increase the size of the allocated memory
pMemory = MemoryManager.Reallocate(pMemory, BytesInChunk * 2);
// Confirm the validity of the allocated memory
if (pMemory == NULL)
return E_OUTOFMEMORY;
// Confirm the size of the reallocated memory
ATLASSERT(MemoryManager.GetSize(pMemory) == BytesInChunk * 2);
// Free the allocated memory
MemoryManager.Free(pMemory);
return S_OK;
}
int DoMemoryManagerDemonstration()
{
CComHeap heapCom;
CCRTHeap heapCrt;
CLocalHeap heapLocal;
CGlobalHeap heapGlobal;
// It is necessary to provide extra information
// to the constructor when using CWin32Heap
CWin32Heap heapWin32(NULL, 4096);
ATLASSERT(S_OK==MemoryManagerDemonstration(heapCom));
ATLASSERT(S_OK==MemoryManagerDemonstration(heapCrt));
ATLASSERT(S_OK==MemoryManagerDemonstration(heapLocal));
ATLASSERT(S_OK==MemoryManagerDemonstration(heapGlobal));
ATLASSERT(S_OK==MemoryManagerDemonstration(heapWin32));
return 0;
}
Gereksinimler
Üst bilgi: atlmem.h
IAtlMemMgr::Allocate
Bir bellek bloğu ayırmak için bu yöntemi çağırın.
void* Allocate(size_t nBytes) throw();
Parametreler
nBayt
Yeni bellek bloğunda istenen bayt sayısı.
İade Değeri
Yeni ayrılan bellek bloğunun başlangıcına bir işaretçi döndürür.
Açıklamalar
Bu yöntem tarafından ayrılan belleği boşaltmak için IAtlMemMgr::Free veya IAtlMemMgr::Reallocate öğesini çağırın.
Örnek
Bir örnek için bkz . IAtlMemMgr'ye Genel Bakış.
IAtlMemMgr::Free
Bellek bloğunu boşaltmak için bu yöntemi çağırın.
void Free(void* p) throw();
Parametreler
P
Bu bellek yöneticisi tarafından daha önce ayrılan belleğe işaretçi.
Açıklamalar
IAtlMemMgr::Allocate veya IAtlMemMgr::Reallocate tarafından alınan belleği boşaltmak için bu yöntemi kullanın.
Örnek
Bir örnek için bkz . IAtlMemMgr'ye Genel Bakış.
IAtlMemMgr::GetSize
Ayrılmış bellek bloğunun boyutunu almak için bu yöntemi çağırın.
size_t GetSize(void* p) throw();
Parametreler
P
Bu bellek yöneticisi tarafından daha önce ayrılan belleğe işaretçi.
İade Değeri
Bellek bloğunun boyutunu bayt cinsinden döndürür.
Örnek
Bir örnek için bkz . IAtlMemMgr'ye Genel Bakış.
IAtlMemMgr::Reallocate
Bu bellek yöneticisi tarafından ayrılan belleği yeniden dağıtmak için bu yöntemi çağır.
void* Reallocate(void* p, size_t nBytes) throw();
Parametreler
P
Bu bellek yöneticisi tarafından daha önce ayrılan belleğe işaretçi.
nBayt
Yeni bellek bloğunda istenen bayt sayısı.
İade Değeri
Yeni ayrılan bellek bloğunun başlangıcına bir işaretçi döndürür.
Açıklamalar
Bu yöntem tarafından ayrılan belleği boşaltmak için IAtlMemMgr::Free veya IAtlMemMgr::Reallocate öğesini çağırın.
Kavramsal olarak bu yöntem mevcut belleği boşaltıp yeni bir bellek bloğu ayırır. Gerçekte, mevcut bellek uzatılabilir veya başka bir şekilde yeniden kullanılabilir.
Örnek
Bir örnek için bkz . IAtlMemMgr'ye Genel Bakış.
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.
IAxWinAmbientDispatchEx::SetAmbientDispatch
Bu yöntem, varsayılan ortam özelliği arabirimini kullanıcı tanımlı bir arabirimle desteklemek için çağrılır.
virtual HRESULT STDMETHODCALLTYPE SetAmbientDispatch(IDispatch* pDispatch) = 0;
Parametreler
pDispatch
Yeni arabirim işaretçisi.
İade Değeri
Başarıda S_OK veya hatada HRESULT hatası döndürür.
Açıklamalar
Yeni bir arabirim işaretçisi ile çağrıldığındaSetAmbientDispatch
, bu yeni arabirim barındırılan denetim tarafından istenen özellikleri veya yöntemleri çağırmak için kullanılır ; bu özellikler IAxWinAmbientDispatch tarafından henüz sağlanmadıysa.
IAxWinHostWindow::AttachControl
hWnd tarafından tanımlanan pencereyi kullanarak konak nesnesine mevcut (ve daha önce başlatılan) bir denetim ekler.
STDMETHOD(AttachControl)(IUnknown* pUnkControl, HWND hWnd);
Parametreler
pUnkControl
[in] Konak nesnesine IUnknown
eklenecek denetimin arabirimine ilişkin bir işaretçi.
Hwnd
[in] Barındırma için kullanılacak pencerenin tutamacı.
İade Değeri
Standart bir HRESULT değeri.
IAxWinHostWindow::CreateControl
Bir denetim oluşturur, başlatır ve hWnd tarafından tanımlanan pencerede barındırılır.
STDMETHOD(CreateControl)(
LPCOLESTR lpTricsData,
HWND hWnd,
IStream* pStream);
Parametreler
lpTricsData
[in] Oluşturulacak denetimi tanımlayan bir dize. CLSID (küme ayraçlarını içermelidir), ProgID, URL veya ham HTML (MSHTML: ön ekini içerir) olabilir.
Hwnd
[in] Barındırma için kullanılacak pencerenin tutamacı.
pStream
[in] Denetim için başlatma verilerini içeren bir akış için arabirim işaretçisi. NULL olabilir.
İade Değeri
Standart bir HRESULT değeri.
Açıklamalar
Bu pencere, iletilerin denetime yansıtılabilmesi ve diğer kapsayıcı özelliklerinin çalışması için bu arabirimi gösteren konak nesnesi tarafından alt sınıfa alınacaktır.
Bu yöntemi çağırmak, IAxWinHostWindow::CreateControlEx çağrısıyla eşdeğerdir.
Lisanslı bir ActiveX denetimi oluşturmak için bkz . IAxWinHostWindowLic::CreateControlLic.
IAxWinHostWindow::CreateControlEx
IAxWinHostWindow::CreateControl gibi bir ActiveX denetimi oluşturur, bunu başlatır ve belirtilen pencerede barındırabilir.
STDMETHOD(CreateControlEx)(
LPCOLESTR lpszTricsData,
HWND hWnd,
IStream* pStream,
IUnknown** ppUnk,
REFIID riidAdvise,
IUnknown* punkAdvise);
Parametreler
lpTricsData
[in] Oluşturulacak denetimi tanımlayan bir dize. CLSID (küme ayraçlarını içermelidir), ProgID, URL veya ham HTML (MSHTML: ön ekli) olabilir.
Hwnd
[in] Barındırma için kullanılacak pencerenin tutamacı.
pStream
[in] Denetim için başlatma verilerini içeren bir akış için arabirim işaretçisi. NULL olabilir.
ppUnk
[out] Oluşturulan denetimin arabirimini IUnknown
alacak bir işaretçinin adresi. NULL olabilir.
riidAdvise
[in] İçerilen nesnedeki giden arabirimin arabirim tanımlayıcısı. IID_NULL olabilir.
punkAdvise
[in] tarafından iidSink
belirtilen kapsanan nesnedeki bağlantı noktasına bağlanacak havuz nesnesinin arabirimine yönelik bir işaretçiIUnknown
.
İade Değeri
Standart bir HRESULT değeri.
Açıklamalar
yönteminden CreateControl
farklı olarak, CreateControlEx
yeni oluşturulan denetim için bir arabirim işaretçisi almanıza ve denetim tarafından tetiklenen olayları almak için bir olay havuzu ayarlamanıza da olanak tanır.
Lisanslı bir ActiveX denetimi oluşturmak için bkz . IAxWinHostWindowLic::CreateControlLicEx.
IAxWinHostWindow::QueryControl
Barındırılan denetim tarafından sağlanan belirtilen arabirim işaretçisini döndürür.
STDMETHOD(QueryControl)(REFIID riid, void** ppvObject);
Parametreler
Riid
[in] İstenen denetimdeki bir arabirimin kimliği.
ppvObject
[out] Oluşturulan denetimin belirtilen arabirimini alacak bir işaretçinin adresi.
İade Değeri
Standart bir HRESULT değeri.
IAxWinHostWindow::SetExternalDispatch
IDocHostUIHandlerDispatch::GetExternal yöntemi aracılığıyla kapsanan denetimler için kullanılabilen dış dispinterface'i ayarlar.
STDMETHOD(SetExternalDispatch)(IDispatch* pDisp);
Parametreler
pDisp
[in] Arabirim işaretçisi IDispatch
.
İade Değeri
Standart bir HRESULT değeri.
IAxWinHostWindow::SetExternalUIHandler
Nesnenin dış IDocHostUIHandlerDispatch arabirimini ayarlamak için bu işlevi çağırın CAxWindow
.
STDMETHOD(SetExternalUIHandler)(IDocHostUIHandlerDispatch* pDisp);
Parametreler
pDisp
[in] Arabirim işaretçisi IDocHostUIHandlerDispatch
.
İade Değeri
Standart bir HRESULT değeri.
Açıklamalar
Bu işlev, arabirimi için IDocHostUIHandlerDispatch
konağın sitesini sorgulayan denetimler (Web tarayıcısı denetimi gibi) tarafından kullanılır.
IAxWinHostWindowLic::CreateControlLic
Lisanslı bir denetim oluşturur, başlatır ve tarafından hWnd
tanımlanan pencerede barındırılır.
STDMETHOD(CreateControlLic)(
LPCOLESTR lpTricsData,
HWND hWnd,
IStream* pStream,
BSTR bstrLic);
Parametreler
bstrLic
[in] Denetimin lisans anahtarını içeren BSTR.
Açıklamalar
Kalan parametrelerin ve dönüş değerinin açıklaması için bkz . IAxWinHostWindow::CreateControl .
Bu yöntemi çağırmak, IAxWinHostWindowLic::CreateControlLicEx çağrısıyla eşdeğerdir
Örnek
kullanan IAxWinHostWindowLic::CreateControlLic
bir örnek için bkz. ATL AXHost Kullanarak ActiveX Denetimlerini Barındırma.
IAxWinHostWindowLic::CreateControlLicEx
IAxWinHostWindow::CreateControl gibi lisanslı bir ActiveX denetimi oluşturur, bunu başlatır ve belirtilen pencerede barındırabilir.
STDMETHOD(CreateControlLicEx)(
LPCOLESTR lpszTricsData,
HWND hWnd,
IStream* pStream,
IUnknown** ppUnk,
REFIID riidAdvise,
IUnknown* punkAdvise,
BSTR bstrLic);
Parametreler
bstrLic
[in] Denetimin lisans anahtarını içeren BSTR.
Açıklamalar
Kalan parametrelerin ve dönüş değerinin açıklaması için bkz . IAxWinHostWindow::CreateControlEx .
Örnek
kullanan IAxWinHostWindowLic::CreateControlLicEx
bir örnek için bkz. ATL AXHost Kullanarak ActiveX Denetimlerini Barındırma.
Ayrıca bkz.
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin