Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of mappen te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen om mappen te wijzigen.
Opmerking
De ATL (Active Template Library) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.
Deze klasse biedt methoden voor het bewerken van een venster dat als host fungeert voor een ActiveX-besturingselement.
Belangrijk
Deze klasse en de bijbehorende leden kunnen niet worden gebruikt in toepassingen die worden uitgevoerd in Windows Runtime.
Syntaxis
class CAxWindow : public CWindow
Leden
Methods
| Functie | Description |
|---|---|
| AttachControl | Hiermee wordt een bestaand ActiveX-besturingselement aan het CAxWindow object gekoppeld. |
| CAxWindow | Maakt een CAxWindow-object. |
| Createcontrol | Hiermee maakt u een ActiveX-besturingselement, initialiseert u het en hostt u dit in het CAxWindow venster. |
| CreateControlEx | Hiermee maakt u een ActiveX-besturingselement en haalt u een interfaceaanwijzer (of aanwijzers) op uit het besturingselement. |
| GetWndClassName | (Statisch) Haalt de vooraf gedefinieerde klassenaam van het CAxWindow object op. |
| QueryControl | Haalt het IUnknown gehoste ActiveX-besturingselement op. |
| QueryHost | Hiermee haalt u de IUnknown aanwijzer van het CAxWindow object op. |
| SetExternalDispatch | Hiermee stelt u de externe verzendinterface in die door het CAxWindow object wordt gebruikt. |
| SetExternalUIHandler | Hiermee stelt u de externe IDocHostUIHandler interface in die door het CAxWindow object wordt gebruikt. |
Bedieners
| Operator | Description |
|---|---|
| operator = | Hiermee wijst u een HWND toe aan een bestaand CAxWindow object. |
Opmerkingen
Deze klasse biedt methoden voor het bewerken van een venster dat als host fungeert voor een ActiveX-besturingselement. De hosting wordt geleverd door " AtlAxWin80", die wordt verpakt door CAxWindow.
Klasse CAxWindow wordt geïmplementeerd als specialisatie van de CAxWindowT klasse. Deze specialisatie wordt gedeclareerd als:
typedef CAxWindowT<CWindow> CAxWindow;
Als u de basisklasse wilt wijzigen, kunt u de nieuwe basisklasse gebruiken CAxWindowT en opgeven als sjabloonargument.
Requirements
Koptekst: atlwin.h
CAxWindow::AttachControl
Hiermee maakt u een nieuw hostobject als deze nog niet aanwezig is en het opgegeven besturingselement aan de host koppelt.
HRESULT AttachControl(
IUnknown* pControl,
IUnknown** ppUnkContainer);
Parameterwaarden
pControl
[in] Een aanwijzer naar het IUnknown besturingselement.
ppUnkContainer
[uit] Een aanwijzer naar de IUnknown host (het AxWin object).
Retourwaarde
Een standaard HRESULT-waarde.
Opmerkingen
Het besturingselementobject dat wordt gekoppeld, moet correct worden geïnitialiseerd voordat u aanroept AttachControl.
CAxWindow::CAxWindow
Hiermee maakt u een CAxWindow object met behulp van een bestaande vensterobjectgreep.
CAxWindow(HWND hWnd = NULL);
Parameterwaarden
hWnd
Een ingang naar een bestaand vensterobject.
CAxWindow::CreateControl
Hiermee maakt u een ActiveX-besturingselement, initialiseert u dit en hostt u dit in het opgegeven venster.
HRESULT CreateControl(
LPCOLESTR lpszName,
IStream* pStream = NULL,
IUnknown** ppUnkContainer = NULL);
HRESULT CreateControl(
DWORD dwResID,
IStream* pStream = NULL,
IUnknown** ppUnkContainer = NULL);
Parameterwaarden
lpszName
Een aanwijzer naar een tekenreeks om het besturingselement te maken. Moet op een van de volgende manieren worden opgemaakt:
Een ProgID zoals
"MSCAL.Calendar.7"Een CLSID, zoals
"{8E27C92B-1264-101C-8A2F-040224009C02}"Een URL zoals
"<https://www.microsoft.com>"Een verwijzing naar een actief document, zoals
"file://\\\Documents\MyDoc.doc"Een fragment van HTML, zoals
"MSHTML:\<HTML>\<BODY>This is a line of text\</BODY>\</HTML>"Opmerking
"MSHTML:"moet voorafgaan aan het HTML-fragment, zodat het wordt aangewezen als een MSHTML-stream. Alleen de ProgID en CLSID worden ondersteund in Windows Mobile-platforms. Ingesloten Windows CE-platforms, met uitzondering van Windows Mobile met ondersteuning voor CE IE, bieden ondersteuning voor alle typen, waaronder ProgID, CLSID, URL, verwijzing naar het actieve document en het fragment van HTML.
pStream
[in] Een aanwijzer naar een stroom die wordt gebruikt om de eigenschappen van het besturingselement te initialiseren. Kan NULL zijn.
ppUnkContainer
[uit] Het adres van een aanwijzer die de IUnknown container ontvangt. Kan NULL zijn.
dwResID
De resource-id van een HTML-resource. Het besturingselement Webbrowser wordt gemaakt en geladen met de opgegeven resource.
Retourwaarde
Een standaard HRESULT-waarde.
Opmerkingen
Als de tweede versie van deze methode wordt gebruikt, wordt er een HTML-besturingselement gemaakt en gebonden aan de resource die is geïdentificeerd door dwResID.
Met deze methode krijgt u hetzelfde resultaat als aanroepen:
AtlAxCreateControlEx(lpszName, hWnd, pStream, NULL, NULL, GUID_NULL, NULL);
Zie CAxWindow2T::CreateControlLic voor het maken, initialiseren en hosten van een gelicentieerd ActiveX-besturingselement.
Example
Zie ActiveX-besturingselementen hosten met ATL AXHost voor een voorbeeld dat wordt gebruikt CreateControl.
CAxWindow::CreateControlEx
Hiermee maakt u een ActiveX-besturingselement, initialiseert u dit en hostt u dit in het opgegeven venster.
HRESULT CreateControlEx(
LPCOLESTR lpszName,
IStream* pStream = NULL,
IUnknown** ppUnkContainer = NULL,
IUnknown** ppUnkControl = NULL,
REFIID iidSink = IID_NULL,
IUnknown* punkSink = NULL);
HRESULT CreateControlEx(
DWORD dwResID,
IStream* pStream = NULL,
IUnknown** ppUnkContainer = NULL,
IUnknown** ppUnkControl = NULL,
REFIID iidSink = IID_NULL,
IUnknown* punkSink = NULL);
Parameterwaarden
lpszName
Een aanwijzer naar een tekenreeks om het besturingselement te maken. Moet op een van de volgende manieren worden opgemaakt:
Een ProgID zoals
"MSCAL.Calendar.7"Een CLSID, zoals
"{8E27C92B-1264-101C-8A2F-040224009C02}"Een URL zoals
"<https://www.microsoft.com>"Een verwijzing naar een actief document, zoals
"file://\\\Documents\MyDoc.doc"Een fragment van HTML, zoals
"MSHTML:\<HTML>\<BODY>This is a line of text\</BODY>\</HTML>"Opmerking
"MSHTML:"moet voorafgaan aan het HTML-fragment, zodat het wordt aangewezen als een MSHTML-stream. Alleen de ProgID en CLSID worden ondersteund in Windows Mobile-platforms. Ingesloten Windows CE-platforms, met uitzondering van Windows Mobile met ondersteuning voor CE IE, bieden ondersteuning voor alle typen, waaronder ProgID, CLSID, URL, verwijzing naar het actieve document en het fragment van HTML.
pStream
[in] Een aanwijzer naar een stroom die wordt gebruikt om de eigenschappen van het besturingselement te initialiseren. Kan NULL zijn.
ppUnkContainer
[uit] Het adres van een aanwijzer die de IUnknown container ontvangt. Kan NULL zijn.
ppUnkControl
[uit] Het adres van een aanwijzer die het IUnknown besturingselement ontvangt. Kan NULL zijn.
iidSink
[in] De interface-id van een uitgaande interface op het ingesloten object. Kan worden IID_NULL.
punkSink
[in] Een aanwijzer naar de IUnknown interface van het sinkobject dat moet worden verbonden met het verbindingspunt op het ingesloten object dat is opgegeven door iidSink.
dwResID
[in] De resource-id van een HTML-resource. Het besturingselement Webbrowser wordt gemaakt en geladen met de opgegeven resource.
Retourwaarde
Een standaard HRESULT-waarde.
Opmerkingen
Deze methode is vergelijkbaar met CAxWindow::CreateControl, maar in tegenstelling tot die 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.
Zie CAxWindow2T::CreateControlLicEx voor het maken, initialiseren en hosten van een gelicentieerd ActiveX-besturingselement.
Example
Zie ActiveX-besturingselementen hosten met ATL AXHost voor een voorbeeld dat wordt gebruikt CreateControlEx.
CAxWindow::GetWndClassName
Haalt de naam van de vensterklasse op.
static LPCTSTR GetWndClassName();
Retourwaarde
Een aanwijzer naar een tekenreeks met de naam van de vensterklasse die niet-gelicentieerde ActiveX-besturingselementen kan hosten.
CAxWindow::operator =
Hiermee wijst u een HWND toe aan een bestaand CAxWindow object.
CAxWindow<TBase>& operator=(HWND hWnd);
Parameterwaarden
hWnd
Een ingang naar een bestaand venster.
Retourwaarde
Retourneert een verwijzing naar het huidige CAxWindow object.
CAxWindow::QueryControl
Haalt de opgegeven interface van het gehoste besturingselement op.
HRESULT QueryControl(REFIID iid, void** ppUnk);
template <class Q>
HRESULT QueryControl(Q** ppUnk);
Parameterwaarden
iid
[in] Hiermee geeft u de IID van de interface van het besturingselement.
ppUnk
[uit] Een aanwijzer naar de interface van het besturingselement. In de sjabloonversie van deze methode is er geen referentie-id nodig zolang een getypte interface met een gekoppelde UUID wordt doorgegeven.
Q
[in] De interface waarvoor een query wordt uitgevoerd.
Retourwaarde
Een standaard HRESULT-waarde.
CAxWindow::QueryHost
Retourneert de opgegeven interface van de host.
HRESULT QueryHost(REFIID iid, void** ppUnk);
template <class Q>
HRESULT QueryHost(Q** ppUnk);
Parameterwaarden
iid
[in] Hiermee geeft u de IID van de interface van het besturingselement.
ppUnk
[uit] Een aanwijzer naar de interface op de host. In de sjabloonversie van deze methode is er geen referentie-id nodig zolang een getypte interface met een gekoppelde UUID wordt doorgegeven.
Q
[in] De interface waarvoor een query wordt uitgevoerd.
Retourwaarde
Een standaard HRESULT-waarde.
Opmerkingen
De interface van de host biedt toegang tot de onderliggende functionaliteit van de vensterhostingcode, geïmplementeerd door AxWin.
CAxWindow::SetExternalDispatch
Hiermee stelt u de interface voor externe verzending voor het CAxWindow object in.
HRESULT SetExternalDispatch(IDispatch* pDisp);
Parameterwaarden
pDisp
[in] Een aanwijzer naar een IDispatch interface.
Retourwaarde
Een standaard HRESULT-waarde.
CAxWindow::SetExternalUIHandler
Hiermee stelt u de externe IDocHostUIHandlerDispatch-interface voor het CAxWindow object in.
HRESULT SetExternalUIHandler(IDocHostUIHandlerDispatch* pUIHandler);
Parameterwaarden
pUIHandler
[in] Een aanwijzer naar een IDocHostUIHandlerDispatch interface.
Retourwaarde
Een standaard HRESULT-waarde.
Opmerkingen
De externe IDocHostUIHandlerDispatch interface wordt gebruikt door besturingselementen die een query uitvoeren op de site van de host voor de IDocHostUIHandlerDispatch interface. Het besturingselement WebBrowser is één besturingselement dat dit doet.
Zie ook
ATLCON-voorbeeld
CWindow-klasse
Grondbeginselen van samengesteld besturingselement
Overzicht van klassen
Veelgestelde vragen over besturingselementen