Aracılığıyla paylaş

IAtlMemMgr Sınıfı

Not

Etkin Şablon Kitaplığı (ATL) desteklenmeye devam eder. Ancak artık özellik eklemeyeceğiz veya belgeleri güncelleştirmeyeceğiz.

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

Veri Akışı Adı Açıklama
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.

Not

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ı.

Dönüş 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.

Dönüş 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ı.

Dönüş 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.

Dönüş 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.

Dönüş 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.

Dönüş 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.

Dönüş 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.

Dönüş 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.

Dönüş 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.

Dönüş 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.

Dönüş 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.

Dönüş 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.

Dönüş 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ü açıklamalı alt yazıları, hata iletisi metnini vb. bir kaynak dosyasından veya uydu DLL'den yüklemek için kodu çağırabilirsiniz.

IAxWinAmbientDispatch::get_MessageReflect

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

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

Dönüş 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.

Dönüş 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.

Dönüş 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.

Dönüş 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.

Dönüş 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.

Dönüş 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.

Dönüş 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.

Dönüş 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.

Dönüş 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.

Dönüş 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.

Dönüş 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.

Dönüş 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.

Dönüş 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.

Dönüş 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.

Dönüş 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_MessageReflect

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

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

Dönüş 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.

Dönüş 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.

Dönüş 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.

Dönüş 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ı.

Dönüş 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.

Dönüş 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 IUnknownbelirtilen kapsanan nesnedeki bağlantı noktasına bağlanacak havuz nesnesinin arabirimine yönelik bir işaretçiiidSink.

Dönüş 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.

Dönüş 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 .

Dönüş 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 .

Dönüş 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 hWndtanı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 bir örnek için bkzIAxWinHostWindowLic::CreateControlLic 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 bir örnek için bkzIAxWinHostWindowLic::CreateControlLicEx Kullanarak ActiveX Denetimlerini Barındırma.

Ayrıca bkz.

Sınıfa Genel Bakış

  • Last updated on