IAxWinHostWindow-Schnittstelle

Diese Schnittstelle stellt Methoden zum Bearbeiten eines Steuerelements und seines Hostobjekts bereit.

Wichtig

Diese Klasse und ihre Member können nicht in Anwendungen verwendet werden, die in der Windows-Runtime ausgeführt werden.

Syntax

interface IAxWinHostWindow : IUnknown

Member

Methoden

Name	Beschreibung
AttachControl	Fügt ein vorhandenes Steuerelement an das Hostobjekt an.
CreateControl	Erstellt ein Steuerelement und fügt es an das Hostobjekt an.
CreateControlEx	Erstellt ein Steuerelement, fügt es an das Hostobjekt an und richtet optional einen Ereignishandler ein.
QueryControl	Gibt einen Schnittstellenzeiger auf das gehostete Steuerelement zurück.
SetExternalDispatch	Legt die externe IDispatch Schnittstelle fest.
SetExternalUIHandler	Legt die externe IDocHostUIHandlerDispatch Schnittstelle fest.

Hinweise

Diese Schnittstelle wird durch das Hostobjekt des ActiveX-Steuerelements von ATL verfügbar gemacht. Rufen Sie die Methoden auf dieser Schnittstelle auf, um ein Steuerelement zum Erstellen und/oder Anfügen eines Steuerelements an das Hostobjekt anzufügen, um eine Schnittstelle von einem gehosteten Steuerelement abzurufen oder den externen Dispinterface- oder UI-Handler für die Verwendung beim Hosten des Webbrowsers festzulegen.

Anforderungen

Die Definition dieser Schnittstelle ist wie unten dargestellt als IDL oder C++ verfügbar.

Definitionstyp	Datei
IDL	ATLIFace.idl
C++	ATLIFace.h (auch in ATLBase.h enthalten)

IAxWinHostWindow::AttachControl

Fügt ein vorhandenes (und zuvor initialisiertes) Steuerelement mithilfe des durch hWnd identifizierten Fensters an das Hostobjekt an.

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

Parameter

pUnkControl
[in] Ein Zeiger auf die IUnknown Schnittstelle des Steuerelements, das an das Hostobjekt angefügt werden soll.

hWnd
[in] Ein Handle für das Fenster, das für das Hosting verwendet werden soll.

Rückgabewert

Ein HRESULT-Standardwert.

IAxWinHostWindow::CreateControl

Erstellt ein Steuerelement, initialisiert es und hostet es im fenster, das von hWnd identifiziert wird.

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

Parameter

lpTricsData
[in] Eine Zeichenfolge, die das zu erstellende Steuerelement identifiziert. Kann eine CLSID (muss die geschweiften Klammern enthalten), ProgID, URL oder unformatierte HTML (präfixt durch MSHTML:).

hWnd
[in] Ein Handle für das Fenster, das für das Hosting verwendet werden soll.

pStream
[in] Ein Schnittstellenzeiger für einen Datenstrom, der Initialisierungsdaten für das Steuerelement enthält. Kann den Wert NULL haben.

Rückgabewert

Ein HRESULT-Standardwert.

Hinweise

Dieses Fenster wird von dem Hostobjekt unterklassigt, das diese Schnittstelle verfügbar gibt, sodass Nachrichten an das Steuerelement widergespiegelt werden können und andere Containerfeatures funktionieren.

Das Aufrufen dieser Methode entspricht dem Aufrufen von IAxWinHostWindow::CreateControlEx.

Informationen zum Erstellen eines lizenzierten ActiveX-Steuerelements finden Sie unter "IAxWinHostWindowLic::CreateControlLic".

IAxWinHostWindow::CreateControlEx

Erstellt ein ActiveX-Steuerelement, initialisiert es und hostet es im angegebenen Fenster, ähnlich wie IAxWinHostWindow::CreateControl.

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

Parameter

lpTricsData
[in] Eine Zeichenfolge, die das zu erstellende Steuerelement identifiziert. Kann eine CLSID (muss die geschweiften Klammern enthalten), ProgID, URL oder unformatierte HTML (präfixt mit MSHTML:).

hWnd
[in] Ein Handle für das Fenster, das für das Hosting verwendet werden soll.

pStream
[in] Ein Schnittstellenzeiger für einen Datenstrom, der Initialisierungsdaten für das Steuerelement enthält. Kann den Wert NULL haben.

ppUnk
[out] Die Adresse eines Zeigers, der die IUnknown Schnittstelle des erstellten Steuerelements empfängt. Kann den Wert NULL haben.

riidAdvise
[in] Der Schnittstellenbezeichner einer ausgehenden Schnittstelle für das enthaltene Objekt. Kann IID_NULL werden.

punkAdvise
[in] Ein Zeiger auf die IUnknown Schnittstelle des Sinkobjekts, das mit dem Verbindungspunkt des enthaltenen Objekts iidSinkverbunden werden soll.

Rückgabewert

Ein HRESULT-Standardwert.

Hinweise

CreateControl Im Gegensatz zur Methode können Sie auch einen Schnittstellenzeiger auf das neu erstellte Steuerelement empfangen und eine Ereignissenke einrichten, um Ereignisse zu empfangen, CreateControlEx die vom Steuerelement ausgelöst werden.

Informationen zum Erstellen eines lizenzierten ActiveX-Steuerelements finden Sie unter "IAxWinHostWindowLicLic::CreateControlLicEx".

IAxWinHostWindow::QueryControl

Gibt den angegebenen Schnittstellenzeiger zurück, der vom gehosteten Steuerelement bereitgestellt wird.

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

Parameter

riid
[in] Die ID einer Schnittstelle für das angeforderte Steuerelement.

ppvObject
[out] Die Adresse eines Zeigers, der die angegebene Schnittstelle des erstellten Steuerelements empfängt.

Rückgabewert

Ein HRESULT-Standardwert.

IAxWinHostWindow::SetExternalDispatch

Legt die externe dispinterface fest, die für enthaltene Steuerelemente über die IDocHostUIHandlerDispatch::GetExternal-Methode verfügbar ist.

STDMETHOD(SetExternalDispatch)(IDispatch* pDisp);

Parameter

pDisp
[in] Ein Zeiger auf eine IDispatch Schnittstelle.

Rückgabewert

Ein HRESULT-Standardwert.

IAxWinHostWindow::SetExternalUIHandler

Rufen Sie diese Funktion auf, um die externe IDocHostUIHandlerDispatch-Schnittstelle für das CAxWindow Objekt festzulegen.

STDMETHOD(SetExternalUIHandler)(IDocHostUIHandlerDispatch* pDisp);

Parameter

pDisp
[in] Ein Zeiger auf eine IDocHostUIHandlerDispatch Schnittstelle.

Rückgabewert

Ein HRESULT-Standardwert.

Hinweise

Diese Funktion wird von Steuerelementen (z. B. dem Webbrowser-Steuerelement) verwendet, die die Website des Hosts für die IDocHostUIHandlerDispatch Schnittstelle abfragen.

Siehe auch

IAxWinAmbientDispatch-Schnittstelle
CAxWindow::QueryHost
AtlAxGetHost