IAxWinHostWindow Interface

Opmerking

De ATL (Active Template Library) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Deze interface biedt methoden voor het bewerken van een besturingselement en het bijbehorende hostobject.

Belangrijk

Deze klasse en de bijbehorende leden kunnen niet worden gebruikt in toepassingen die worden uitgevoerd in Windows Runtime.

Syntaxis

interface IAxWinHostWindow : IUnknown

Leden

Methods

Naam	Description
AttachControl	Hiermee wordt een bestaand besturingselement aan het hostobject gekoppeld.
Createcontrol	Hiermee maakt u een besturingselement en koppelt u dit aan het hostobject.
CreateControlEx	Hiermee maakt u een besturingselement, koppelt u dit aan het hostobject en stelt u desgewenst een gebeurtenis-handler in.
QueryControl	Retourneert een interfaceaanwijzer naar het gehoste besturingselement.
SetExternalDispatch	Hiermee stelt u de externe IDispatch interface in.
SetExternalUIHandler	Hiermee stelt u de externe IDocHostUIHandlerDispatch interface in.

Opmerkingen

Deze interface wordt weergegeven door het ActiveX-besturingselement van ATL dat als host fungeert voor objecten. Roep de methoden op deze interface aan om een besturingselement te maken en/of te koppelen aan het hostobject, om een interface op te halen van een gehost besturingselement of om de externe dispinterface of UI-handler in te stellen voor gebruik bij het hosten van de webbrowser.

Requirements

De definitie van deze interface is beschikbaar als IDL of C++, zoals hieronder wordt weergegeven.

Definitietype	Bestand
IDL	ATLIFace.idl
C++	ATLIFace.h (ook opgenomen in ATLBase.h)

IAxWinHostWindow::AttachControl

Hiermee koppelt u een bestaand besturingselement (en eerder geïnitialiseerd) aan het hostobject met behulp van het venster dat is geïdentificeerd door hWnd.

STDMETHOD(AttachControl)(IUnknown* pUnkControl, HWND hWnd);

Parameterwaarden

pUnkControl
[in] Een aanwijzer naar de IUnknown interface van het besturingselement dat moet worden gekoppeld aan het hostobject.

hWnd
[in] Een ingang voor het venster dat moet worden gebruikt voor hosting.

Retourwaarde

Een standaard HRESULT-waarde.

IAxWinHostWindow::CreateControl

Hiermee maakt u een besturingselement, initialiseert u het en hostt u dit in het venster dat is geïdentificeerd door hWnd.

STDMETHOD(CreateControl)(
    LPCOLESTR lpTricsData,
    HWND hWnd,
    IStream* pStream);

Parameterwaarden

lpTricsData
[in] Een tekenreeks die het besturingselement identificeert dat moet worden gemaakt. Kan een CLSID zijn (moet de accolades bevatten), ProgID, URL of onbewerkte HTML (voorafgegaan door MSHTML:).

hWnd
[in] Een ingang voor het venster dat moet worden gebruikt voor hosting.

pStream
[in] Een interfaceaanwijzer voor een stroom met initialisatiegegevens voor het besturingselement. Kan NULL zijn.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

Dit venster wordt gesubklasseerd door het hostobject dat deze interface weergeeft, zodat berichten kunnen worden weerspiegeld in het besturingselement en andere containerfuncties werken.

Het aanroepen van deze methode komt overeen met het aanroepen van IAxWinHostWindow::CreateControlEx.

Als u een gelicentieerd ActiveX-besturingselement wilt maken, raadpleegt u IAxWinHostWindowLic::CreateControlLic.

IAxWinHostWindow::CreateControlEx

Hiermee maakt u een ActiveX-besturingselement, initialiseert het en hostt u dit in het opgegeven venster, vergelijkbaar met IAxWinHostWindow::CreateControl.

STDMETHOD(CreateControlEx)(
    LPCOLESTR lpszTricsData,
    HWND hWnd,
    IStream* pStream,
    IUnknown** ppUnk,
    REFIID riidAdvise,
    IUnknown* punkAdvise);

Parameterwaarden

lpTricsData
[in] Een tekenreeks die het besturingselement identificeert dat moet worden gemaakt. Kan een CLSID zijn (moet de accolades bevatten), ProgID, URL of onbewerkte HTML (voorafgegaan door MSHTML:).

hWnd
[in] Een ingang voor het venster dat moet worden gebruikt voor hosting.

pStream
[in] Een interfaceaanwijzer voor een stroom met initialisatiegegevens voor het besturingselement. Kan NULL zijn.

ppUnk
[uit] Het adres van een aanwijzer die de IUnknown interface van het gemaakte besturingselement ontvangt. Kan NULL zijn.

riidAdvise
[in] De interface-id van een uitgaande interface op het ingesloten object. Kan worden IID_NULL.

punkAdvise
[in] Een aanwijzer naar de IUnknown interface van het sink-object dat moet worden verbonden met het verbindingspunt op het ingesloten object dat is opgegeven door iidSink.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

In tegenstelling tot de CreateControl methode kunt CreateControlEx u ook een interfaceaanwijzer ontvangen naar het zojuist gemaakte besturingselement en een gebeurtenissink instellen om gebeurtenissen te ontvangen die door het besturingselement worden geactiveerd.

Als u een gelicentieerd ActiveX-besturingselement wilt maken, raadpleegt u IAxWinHostWindowLic::CreateControlLicEx.

IAxWinHostWindow::QueryControl

Retourneert de opgegeven interfacepointer die wordt geleverd door het gehoste besturingselement.

STDMETHOD(QueryControl)(
    REFIID riid,
    void** ppvObject);

Parameterwaarden

riid
[in] De id van een interface op het besturingselement dat wordt aangevraagd.

ppvObject
[uit] Het adres van een aanwijzer die de opgegeven interface van het gemaakte besturingselement ontvangt.

Retourwaarde

Een standaard HRESULT-waarde.

IAxWinHostWindow::SetExternalDispatch

Hiermee stelt u de externe dispinterface in, die beschikbaar is voor ingesloten besturingselementen via de methode IDocHostUIHandlerDispatch::GetExternal .

STDMETHOD(SetExternalDispatch)(IDispatch* pDisp);

Parameterwaarden

pDisp
[in] Een aanwijzer naar een IDispatch interface.

Retourwaarde

Een standaard HRESULT-waarde.

IAxWinHostWindow::SetExternalUIHandler

Roep deze functie aan om de externe IDocHostUIHandlerDispatch-interface voor het CAxWindow object in te stellen.

STDMETHOD(SetExternalUIHandler)(IDocHostUIHandlerDispatch* pDisp);

Parameterwaarden

pDisp
[in] Een aanwijzer naar een IDocHostUIHandlerDispatch interface.

Retourwaarde

Een standaard HRESULT-waarde.

Opmerkingen

Deze functie wordt gebruikt door besturingselementen (zoals het webbrowserbesturingselement) die een query uitvoeren op de site van de host voor de IDocHostUIHandlerDispatch interface.

Zie ook

IAxWinAmbientDispatch Interface
CAxWindow::QueryHost
AtlAxGetHost