IAtlMemMgr – třída
Tato třída představuje rozhraní správce paměti.
Syntaxe
__interface __declspec(uuid("654F7EF5-CFDF-4df9-A450-6C6A13C622C0")) IAtlMemMgr
Členové
Metody
| Název | Popis |
|---|---|
| Přidělit | Voláním této metody přidělte blok paměti. |
| Zadejte možnost pro bezplatnou SKU. | Voláním této metody uvolníte blok paměti. |
| GetSize | Voláním této metody načtěte velikost přiděleného bloku paměti. |
| Přerozdělit | Voláním této metody relokujte blok paměti. |
Poznámky
Toto rozhraní je implementováno CComHeap, CCRTHeap, CLocalHeap, CGlobalHeap nebo CWin32Heap.
Poznámka:
Místní a globální funkce haldy jsou pomalejší než jiné funkce správy paměti a neposkytují tolik funkcí. Nové aplikace by proto měly používat funkce haldy. Jsou k dispozici ve třídě CWin32Heap .
Příklad
// 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;
}
Požadavky
Hlavička: atlmem.h
IAtlMemMgr::Přidělení
Voláním této metody přidělte blok paměti.
void* Allocate(size_t nBytes) throw();
Parametry
nBajty
Požadovaný počet bajtů v novém bloku paměti.
Návratová hodnota
Vrátí ukazatel na začátek nově přiděleného bloku paměti.
Poznámky
Volání IAtlMemMgr::Free nebo IAtlMemMgr::Reallocate uvolnit paměť přidělenou touto metodou.
Příklad
Příklad najdete v přehledu IAtlMemMgr.
IAtlMemMgr::Free
Voláním této metody uvolníte blok paměti.
void Free(void* p) throw();
Parametry
p
Ukazatel na paměť dříve přidělený tímto správcem paměti.
Poznámky
Tato metoda slouží k uvolnění paměti získané pomocí IAtlMemMgr::Allocate nebo IAtlMemMgr::Reallocate.
Příklad
Příklad najdete v přehledu IAtlMemMgr.
IAtlMemMgr::GetSize
Voláním této metody načtěte velikost přiděleného bloku paměti.
size_t GetSize(void* p) throw();
Parametry
p
Ukazatel na paměť dříve přidělený tímto správcem paměti.
Návratová hodnota
Vrátí velikost bloku paměti v bajtech.
Příklad
Příklad najdete v přehledu IAtlMemMgr.
IAtlMemMgr::Reallocate
Voláním této metody relokuje paměť přidělenou tímto správcem paměti.
void* Reallocate(void* p, size_t nBytes) throw();
Parametry
p
Ukazatel na paměť dříve přidělený tímto správcem paměti.
nBajty
Požadovaný počet bajtů v novém bloku paměti.
Návratová hodnota
Vrátí ukazatel na začátek nově přiděleného bloku paměti.
Poznámky
Volání IAtlMemMgr::Free nebo IAtlMemMgr::Reallocate uvolnit paměť přidělenou touto metodou.
Koncepčně tato metoda uvolní existující paměť a přidělí nový blok paměti. Ve skutečnosti může být stávající paměť rozšířena nebo jinak znovu použita.
Příklad
Příklad najdete v přehledu IAtlMemMgr.
IAxWinAmbientDispatch::get_AllowContextMenu
Vlastnost AllowContextMenu určuje, zda hostovaný ovládací prvek může zobrazit vlastní místní nabídku.
STDMETHOD(get_AllowContextMenu)(VARIANT_BOOL* pbAllowContextMenu);
Parametry
pbAllowContextMenu
[ven] Adresa proměnné pro příjem aktuální hodnoty této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL používá VARIANT_TRUE jako výchozí hodnotu této vlastnosti.
IAxWinAmbientDispatch::get_AllowShowUI
Vlastnost AllowShowUI určuje, zda hostovaný ovládací prvek může zobrazit vlastní uživatelské rozhraní.
STDMETHOD(get_AllowShowUI)(VARIANT_BOOL* pbAllowShowUI);
Parametry
pbAllowShowUI
[ven] Adresa proměnné pro příjem aktuální hodnoty této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL používá VARIANT_FALSE jako výchozí hodnotu této vlastnosti.
IAxWinAmbientDispatch::get_AllowWindowlessActivation
Vlastnost AllowWindowlessActivation určuje, jestli kontejner povolí aktivaci bez oken.
STDMETHOD(get_AllowWindowlessActivation)(VARIANT_BOOL* pbAllowWindowless);
Parametry
pbAllowWindowless
[ven] Adresa proměnné pro příjem aktuální hodnoty této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL používá VARIANT_TRUE jako výchozí hodnotu této vlastnosti.
IAxWinAmbientDispatch::get_BackColor
Vlastnost BackColor určuje barvu okolního pozadí kontejneru.
STDMETHOD(get_BackColor)(OLE_COLOR* pclrBackground);
Parametry
pclrBackground
[ven] Adresa proměnné pro příjem aktuální hodnoty této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL používá COLOR_BTNFACE nebo COLOR_WINDOW jako výchozí hodnotu této vlastnosti (v závislosti na tom, jestli nadřazený objekt okna hostitele je dialog nebo ne).
IAxWinAmbientDispatch::get_DisplayAsDefault
DisplayAsDefault je okolí vlastnost, která umožňuje ovládací prvek zjistit, zda je to výchozí ovládací prvek.
STDMETHOD(get_DisplayAsDefault)(VARIANT_BOOL* pbDisplayAsDefault);
Parametry
pbDisplayAsDefault
[ven] Adresa proměnné pro příjem aktuální hodnoty této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL používá VARIANT_FALSE jako výchozí hodnotu této vlastnosti.
IAxWinAmbientDispatch::get_DocHostDoubleClickFlags
Vlastnost DocHostDoubleClickFlags určuje operaci, která by měla proběhnout v reakci na dvojité kliknutí.
STDMETHOD(get_DocHostDoubleClickFlags)(DWORD* pdwDocHostDoubleClickFlags);
Parametry
pdwDocHostDoubleClickFlags
[ven] Adresa proměnné pro příjem aktuální hodnoty této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL používá DOCHOSTUIDBLCLK_DEFAULT jako výchozí hodnotu této vlastnosti.
IAxWinAmbientDispatch::get_DocHostFlags
Vlastnost DocHostFlags určuje možnosti uživatelského rozhraní hostitelského objektu.
STDMETHOD(get_DocHostFlags)(DWORD* pdwDocHostFlags);
Parametry
pdwDocHostFlags
[ven] Adresa proměnné pro příjem aktuální hodnoty této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL používá DOCHOSTUIFLAG_NO3DBORDER jako výchozí hodnotu této vlastnosti.
IAxWinAmbientDispatch::get_Font
Vlastnost Font určuje okolní písmo kontejneru.
STDMETHOD(get_Font)(IFontDisp** pFont);
Parametry
pFont
[ven] Adresa IFontDisp ukazatele rozhraní použitého k přijetí aktuální hodnoty této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL používá jako výchozí hodnotu této vlastnosti výchozí písmo grafického uživatelského rozhraní nebo systémové písmo.
IAxWinAmbientDispatch::get_ForeColor
Vlastnost ForeColor určuje okolní barvu popředí kontejneru.
STDMETHOD(get_ForeColor)(OLE_COLOR* pclrForeground);
Parametry
pclrForeground
[ven] Adresa proměnné pro příjem aktuální hodnoty této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace objektu hostitele ATL používá barvu textu systémového okna jako výchozí hodnotu této vlastnosti.
IAxWinAmbientDispatch::get_LocaleID
Vlastnost LocaleID určuje ID okolního národního prostředí kontejneru.
STDMETHOD(get_LocaleID)(LCID* plcidLocaleID);
Parametry
plcidLocaleID
[ven] Adresa proměnné pro příjem aktuální hodnoty této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL používá výchozí národní prostředí uživatele jako výchozí hodnotu této vlastnosti.
Pomocí této metody můžete zjistit Ambient LocalID, tj. LocaleID programu, ve které se používá váš ovládací prvek. Jakmile znáte id národního prostředí, můžete volat kód, který načte titulky specifické pro národní prostředí, text chybové zprávy a tak dále ze souboru prostředků nebo satelitní knihovny DLL.
IAxWinAmbientDispatch::get_MessageReflect
Okolí MessageReflect vlastnost určuje, zda kontejner bude odrážet zprávy hostovaný ovládací prvek.
STDMETHOD(get_MessageReflect)(VARIANT_BOOL* pbMessageReflect);
Parametry
pbMessageReflect
[ven] Adresa proměnné pro příjem aktuální hodnoty této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL používá VARIANT_TRUE jako výchozí hodnotu této vlastnosti.
IAxWinAmbientDispatch::get_OptionKeyPath
Vlastnost OptionKeyPath určuje cestu klíče registru k uživatelským nastavením.
STDMETHOD(get_OptionKeyPath)(BSTR* pbstrOptionKeyPath);
Parametry
pbstrOptionKeyPath
[ven] Adresa proměnné pro příjem aktuální hodnoty této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
IAxWinAmbientDispatch::get_ShowGrabHandles
Okolí ShowGrabHandles vlastnost umožňuje ovládacímu prvku zjistit, zda by se měl kreslit pomocí úchytů pro uchytnutí.
STDMETHOD(get_ShowGrabHandles)(VARIANT_BOOL* pbShowGrabHandles);
Parametry
pbShowGrabHandles
[ven] Adresa proměnné pro příjem aktuální hodnoty této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL vždy vrací VARIANT_FALSE jako hodnota této vlastnosti.
IAxWinAmbientDispatch::get_ShowHatching
Okolí ShowHatching vlastnost umožňuje ovládacímu prvku zjistit, zda by měl nakreslit samotný šrafovaný.
STDMETHOD(get_ShowHatching)(VARIANT_BOOL* pbShowHatching);
Parametry
pbShowHatching
[ven] Adresa proměnné pro příjem aktuální hodnoty této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL vždy vrací VARIANT_FALSE jako hodnota této vlastnosti.
IAxWinAmbientDispatch::get_UserMode
Vlastnost UserMode určuje okolní uživatelský režim kontejneru.
STDMETHOD(get_UserMode)(VARIANT_BOOL* pbUserMode);
Parametry
pbUserMode
[ven] Adresa proměnné pro příjem aktuální hodnoty této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL používá VARIANT_TRUE jako výchozí hodnotu této vlastnosti.
IAxWinAmbientDispatch::p ut_AllowContextMenu
Vlastnost AllowContextMenu určuje, zda hostovaný ovládací prvek může zobrazit vlastní místní nabídku.
STDMETHOD(put_AllowContextMenu)(VARIANT_BOOL bAllowContextMenu);
Parametry
bAllowContextMenu
[v] Nová hodnota této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL používá VARIANT_TRUE jako výchozí hodnotu této vlastnosti.
IAxWinAmbientDispatch::p ut_AllowShowUI
Vlastnost AllowShowUI určuje, zda hostovaný ovládací prvek může zobrazit vlastní uživatelské rozhraní.
STDMETHOD(put_AllowShowUI)(VARIANT_BOOL bAllowShowUI);
Parametry
bAllowShowUI
[v] Nová hodnota této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL používá VARIANT_FALSE jako výchozí hodnotu této vlastnosti.
IAxWinAmbientDispatch::p ut_AllowWindowlessActivation
Vlastnost AllowWindowlessActivation určuje, jestli kontejner povolí aktivaci bez oken.
STDMETHOD(put_AllowWindowlessActivation)(VARIANT_BOOL bAllowWindowless);
Parametry
bAllowWindowless
[v] Nová hodnota této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL používá VARIANT_TRUE jako výchozí hodnotu této vlastnosti.
IAxWinAmbientDispatch::p ut_BackColor
Vlastnost BackColor určuje barvu okolního pozadí kontejneru.
STDMETHOD(put_BackColor)(OLE_COLOR clrBackground);
Parametry
clrBackground
[v] Nová hodnota této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL používá COLOR_BTNFACE nebo COLOR_WINDOW jako výchozí hodnotu této vlastnosti (v závislosti na tom, jestli nadřazený objekt okna hostitele je dialog nebo ne).
IAxWinAmbientDispatch::p ut_DisplayAsDefault
DisplayAsDefault je okolí vlastnost, která umožňuje ovládací prvek zjistit, zda je to výchozí ovládací prvek.
STDMETHOD(put_DisplayAsDefault)(VARIANT_BOOL bDisplayAsDefault);
Parametry
bDisplayAsDefault
[v] Nová hodnota této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL používá VARIANT_FALSE jako výchozí hodnotu této vlastnosti.
IAxWinAmbientDispatch::p ut_DocHostDoubleClickFlags
Vlastnost DocHostDoubleClickFlags určuje operaci, která by měla proběhnout v reakci na dvojité kliknutí.
STDMETHOD(put_DocHostDoubleClickFlags)(DWORD dwDocHostDoubleClickFlags);
Parametry
dwDocHostDoubleClickFlags
[v] Nová hodnota této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL používá DOCHOSTUIDBLCLK_DEFAULT jako výchozí hodnotu této vlastnosti.
IAxWinAmbientDispatch::p ut_DocHostFlags
Vlastnost DocHostFlags určuje možnosti uživatelského rozhraní hostitelského objektu.
STDMETHOD(put_DocHostFlags)(DWORD dwDocHostFlags);
Parametry
dwDocHostFlags
[v] Nová hodnota této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL používá DOCHOSTUIFLAG_NO3DBORDER jako výchozí hodnotu této vlastnosti.
IAxWinAmbientDispatch::p ut_Font
Vlastnost Font určuje okolní písmo kontejneru.
STDMETHOD(put_Font)(IFontDisp* pFont);
Parametry
pFont
[v] Nová hodnota této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL používá jako výchozí hodnotu této vlastnosti výchozí písmo grafického uživatelského rozhraní nebo systémové písmo.
IAxWinAmbientDispatch::p ut_ForeColor
Vlastnost ForeColor určuje okolní barvu popředí kontejneru.
STDMETHOD(put_ForeColor)(OLE_COLOR clrForeground);
Parametry
clrForeground
[v] Nová hodnota této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace objektu hostitele ATL používá barvu textu systémového okna jako výchozí hodnotu této vlastnosti.
IAxWinAmbientDispatch::p ut_LocaleID
Vlastnost LocaleID určuje ID okolního národního prostředí kontejneru.
STDMETHOD(put_LocaleID)(LCID lcidLocaleID);
Parametry
lcidLocaleID
[v] Nová hodnota této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL používá výchozí národní prostředí uživatele jako výchozí hodnotu této vlastnosti.
IAxWinAmbientDispatch::p ut_MessageReflect
Okolí MessageReflect vlastnost určuje, zda kontejner bude odrážet zprávy hostovaný ovládací prvek.
STDMETHOD(put_MessageReflect)(VARIANT_BOOL bMessageReflect);
Parametry
bMessageReflect
[v] Nová hodnota této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL používá VARIANT_TRUE jako výchozí hodnotu této vlastnosti.
IAxWinAmbientDispatch::p ut_OptionKeyPath
Vlastnost OptionKeyPath určuje cestu klíče registru k uživatelským nastavením.
STDMETHOD(put_OptionKeyPath)(BSTR bstrOptionKeyPath);
Parametry
bstrOptionKeyPath
[v] Nová hodnota této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
IAxWinAmbientDispatch::p ut_UserMode
Vlastnost UserMode určuje okolní uživatelský režim kontejneru.
STDMETHOD(put_UserMode)(VARIANT_BOOL bUserMode);
Parametry
bUserMode
[v] Nová hodnota této vlastnosti.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Implementace hostitelského objektu ATL používá VARIANT_TRUE jako výchozí hodnotu této vlastnosti.
IAxWinAmbientDispatchEx::SetAmbientDispatch
Tato metoda je volána k doplnění výchozí okolí vlastnosti rozhraní uživatelem definované rozhraní.
virtual HRESULT STDMETHODCALLTYPE SetAmbientDispatch(IDispatch* pDispatch) = 0;
Parametry
pDispatch
Ukazatel na nové rozhraní.
Návratová hodnota
Vrátí S_OK při úspěchu nebo chybu HRESULT při selhání.
Poznámky
Při SetAmbientDispatch volání s ukazatelem na nové rozhraní bude toto nové rozhraní použito k vyvolání všech vlastností nebo metod požadovaných hostovaným ovládacím prvku – pokud tyto vlastnosti ještě nejsou poskytovány IAxWinAmbientDispatch.
IAxWinHostWindow::AttachControl
Připojí existující (a dříve inicializovaný) ovládací prvek k hostitelskému objektu pomocí okna identifikovaného hWnd.
STDMETHOD(AttachControl)(IUnknown* pUnkControl, HWND hWnd);
Parametry
pUnkControl
[v] Ukazatel na IUnknown rozhraní ovládacího prvku, který se má připojit k hostitelskému objektu.
hWnd
[v] Popisovač okna, který se má použít k hostování.
Návratová hodnota
Standardní hodnota HRESULT.
IAxWinHostWindow::CreateControl
Vytvoří ovládací prvek, inicializuje ho a hostuje ho v okně identifikovaném hWnd.
STDMETHOD(CreateControl)(
LPCOLESTR lpTricsData,
HWND hWnd,
IStream* pStream);
Parametry
lpTricsData
[v] Řetězec identifikující ovládací prvek, který se má vytvořit. Může to být CLSID (musí obsahovat složené závorky), ProgID, ADRESU URL nebo nezpracovaný kód HTML (předpona MSHTML:).
hWnd
[v] Popisovač okna, který se má použít k hostování.
pStream
[v] Ukazatel rozhraní pro datový proud obsahující inicializační data pro ovládací prvek. Může mít hodnotu NULL.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Toto okno bude podtříděno objektem hostitele, který toto rozhraní zpřístupňuje, aby zprávy mohly být promítnuty do ovládacího prvku a další funkce kontejneru budou fungovat.
Volání této metody je ekvivalentní volání IAxWinHostWindow::CreateControlEx.
Pokud chcete vytvořit licencovaný ovládací prvek ActiveX, přečtěte si téma IAxWinHostWindowLic::CreateControlLic.
IAxWinHostWindow::CreateControlEx
Vytvoří ovládací prvek ActiveX, inicializuje ho a hostuje ho v zadaném okně, podobně jako IAxWinHostWindow::CreateControl.
STDMETHOD(CreateControlEx)(
LPCOLESTR lpszTricsData,
HWND hWnd,
IStream* pStream,
IUnknown** ppUnk,
REFIID riidAdvise,
IUnknown* punkAdvise);
Parametry
lpTricsData
[v] Řetězec identifikující ovládací prvek, který se má vytvořit. Může to být CLSID (musí obsahovat složené závorky), ProgID, ADRESU URL nebo nezpracovaný kód HTML (předpona MSHTML:).
hWnd
[v] Popisovač okna, který se má použít k hostování.
pStream
[v] Ukazatel rozhraní pro datový proud obsahující inicializační data pro ovládací prvek. Může mít hodnotu NULL.
ppUnk
[ven] Adresa ukazatele, který obdrží IUnknown rozhraní vytvořeného ovládacího prvku. Může mít hodnotu NULL.
riidAdvise
[v] Identifikátor rozhraní odchozího rozhraní v obsaženém objektu. Může být IID_NULL.
punkAdvise
[v] Ukazatel na IUnknown rozhraní objektu jímky, který má být připojen k spojovacímu bodu na obsaženém objektu určeném iidSink.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
CreateControl Na rozdíl od metody CreateControlEx také umožňuje přijímat ukazatel rozhraní na nově vytvořený ovládací prvek a nastavit jímku událostí pro příjem událostí aktivovaných ovládacím prvku.
Pokud chcete vytvořit licencovaný ovládací prvek ActiveX, přečtěte si téma IAxWinHostWindowLic::CreateControlLicEx.
IAxWinHostWindow::QueryControl
Vrátí zadaný ukazatel rozhraní poskytnutý hostovaným ovládacím prvku.
STDMETHOD(QueryControl)(REFIID riid, void** ppvObject);
Parametry
riid
[v] ID rozhraní požadovaného ovládacího prvku.
ppvObject
[ven] Adresa ukazatele, který obdrží zadané rozhraní vytvořeného ovládacího prvku.
Návratová hodnota
Standardní hodnota HRESULT.
IAxWinHostWindow::SetExternalDispatch
Nastaví externí dispinterface, který je k dispozici pro obsažené ovládací prvky prostřednictvím IDocHostUIHandlerDispatch::GetExternal metoda.
STDMETHOD(SetExternalDispatch)(IDispatch* pDisp);
Parametry
pDisp
[v] Ukazatel na IDispatch rozhraní.
Návratová hodnota
Standardní hodnota HRESULT.
IAxWinHostWindow::SetExternalUIHandler
Voláním této funkce nastavíte externí IDocHostUIHandlerDispatch rozhraní objektu CAxWindow .
STDMETHOD(SetExternalUIHandler)(IDocHostUIHandlerDispatch* pDisp);
Parametry
pDisp
[v] Ukazatel na IDocHostUIHandlerDispatch rozhraní.
Návratová hodnota
Standardní hodnota HRESULT.
Poznámky
Tuto funkci používají ovládací prvky (například ovládací prvek webového prohlížeče), které se dotazují na web hostitele pro IDocHostUIHandlerDispatch rozhraní.
IAxWinHostWindowLic::CreateControlLic
Vytvoří licencovaný ovládací prvek, inicializuje ho a hostuje ho v okně identifikovaném uživatelem hWnd.
STDMETHOD(CreateControlLic)(
LPCOLESTR lpTricsData,
HWND hWnd,
IStream* pStream,
BSTR bstrLic);
Parametry
bstrLic
[v] BSTR, který obsahuje licenční klíč pro ovládací prvek.
Poznámky
Viz IAxWinHostWindow::CreateControl pro popis zbývajících parametrů a návratové hodnoty.
Volání této metody je ekvivalentní volání IAxWinHostWindowLic::CreateControlLicEx
Příklad
Viz Hostování ovládacích prvků ActiveX pomocí ATL AXHost pro ukázku, která používá IAxWinHostWindowLic::CreateControlLic.
IAxWinHostWindowLic::CreateControlLicEx
Vytvoří licencovaný ovládací prvek ActiveX, inicializuje ho a hostuje ho v zadaném okně, podobně jako IAxWinHostWindow::CreateControl.
STDMETHOD(CreateControlLicEx)(
LPCOLESTR lpszTricsData,
HWND hWnd,
IStream* pStream,
IUnknown** ppUnk,
REFIID riidAdvise,
IUnknown* punkAdvise,
BSTR bstrLic);
Parametry
bstrLic
[v] BSTR, který obsahuje licenční klíč pro ovládací prvek.
Poznámky
Viz IAxWinHostWindow::CreateControlEx pro popis zbývajících parametrů a návratové hodnoty.
Příklad
Viz Hostování ovládacích prvků ActiveX pomocí ATL AXHost pro ukázku, která používá IAxWinHostWindowLic::CreateControlLicEx.