Interfejs IAxWinHostWindow

Ten interfejs udostępnia metody manipulowania kontrolką i jej obiektem hosta.

Ważne

Tej klasy i jej składowych nie można używać w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows.

Składnia

interface IAxWinHostWindow : IUnknown

Członkowie

Metody

Nazwa/nazwisko	opis
AttachControl	Dołącza istniejącą kontrolkę do obiektu hosta.
CreateControl	Tworzy kontrolkę i dołącza ją do obiektu hosta.
CreateControlEx	Tworzy kontrolkę, dołącza ją do obiektu hosta i opcjonalnie konfiguruje program obsługi zdarzeń.
Kontrola zapytań	Zwraca wskaźnik interfejsu do hostowanej kontrolki.
SetExternalDispatch	Ustawia interfejs zewnętrzny IDispatch .
SetExternalUIHandler	Ustawia interfejs zewnętrzny IDocHostUIHandlerDispatch .

Uwagi

Ten interfejs jest udostępniany przez obiekty hostowania kontrolek ActiveX atL. Wywołaj metody w tym interfejsie, aby utworzyć i/lub dołączyć kontrolkę do obiektu hosta, uzyskać interfejs z hostowanej kontrolki lub ustawić zewnętrzną procedurę obsługi dispinterface lub interfejsu użytkownika do użycia podczas hostowania przeglądarki sieci Web.

Wymagania

Definicja tego interfejsu jest dostępna jako IDL lub C++, jak pokazano poniżej.

Typ definicji	Plik
IDL	ATLIFace.idl
C++	ATLIFace.h (również w ATLBase.h)

IAxWinHostWindow::AttachControl

Dołącza istniejącą (i wcześniej zainicjowaną) kontrolkę do obiektu hosta przy użyciu okna zidentyfikowanego przez hWnd.

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

Parametry

pUnkControl
[in] Wskaźnik do IUnknown interfejsu kontrolki, która ma być dołączona do obiektu hosta.

Hwnd
[in] Uchwyt do okna, który ma być używany do hostowania.

Wartość zwracana

Standardowa wartość HRESULT.

IAxWinHostWindow::CreateControl

Tworzy kontrolkę, inicjuje ją i hostuje w oknie zidentyfikowanym przez hWnd.

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

Parametry

lpTricsData
[in] Ciąg identyfikujący kontrolkę do utworzenia. Może to być identyfikator CLSID (musi zawierać nawiasy klamrowe), ProgID, URL lub nieprzetworzony kod HTML (poprzedzony ciągiem MSHTML:).

Hwnd
[in] Uchwyt do okna, który ma być używany do hostowania.

pStream
[in] Wskaźnik interfejsu dla strumienia zawierającego dane inicjowania dla kontrolki. Może mieć wartość NULL.

Wartość zwracana

Standardowa wartość HRESULT.

Uwagi

To okno będzie podklasowane przez obiekt hosta uwidaczniając ten interfejs, aby komunikaty mogły być odzwierciedlane w kontrolce, a inne funkcje kontenera będą działać.

Wywołanie tej metody jest równoważne wywołaniu metody IAxWinHostWindow::CreateControlEx.

Aby utworzyć licencjonowany formant ActiveX, zobacz IAxWinHostWindowLic::CreateControlLic.

IAxWinHostWindow::CreateControlEx

Tworzy kontrolkę ActiveX, inicjuje ją i hostuje w określonym oknie, podobnie jak IAxWinHostWindow::CreateControl.

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

Parametry

lpTricsData
[in] Ciąg identyfikujący kontrolkę do utworzenia. Może to być identyfikator CLSID (musi zawierać nawiasy klamrowe), ProgID, URL lub nieprzetworzony kod HTML (poprzedzony plikiem MSHTML:).

Hwnd
[in] Uchwyt do okna, który ma być używany do hostowania.

pStream
[in] Wskaźnik interfejsu dla strumienia zawierającego dane inicjowania dla kontrolki. Może mieć wartość NULL.

ppUnk
[out] Adres wskaźnika, który otrzyma IUnknown interfejs utworzonej kontrolki. Może mieć wartość NULL.

riidAdvise
[in] Identyfikator interfejsu interfejsu wychodzącego w zawartym obiekcie. Może być IID_NULL.

punkAdvise
[in] Wskaźnik do IUnknown interfejsu obiektu ujścia, który ma być połączony z punktem połączenia dla zawartego obiektu określonego przez iidSink.

Wartość zwracana

Standardowa wartość HRESULT.

Uwagi

CreateControl W przeciwieństwie do metody, CreateControlEx umożliwia również odbieranie wskaźnika interfejsu do nowo utworzonej kontrolki i skonfigurowanie ujścia zdarzeń w celu odbierania zdarzeń wyzwalanych przez kontrolkę.

Aby utworzyć licencjonowany formant ActiveX, zobacz IAxWinHostWindowLic::CreateControlLicEx.

IAxWinHostWindow::QueryControl

Zwraca określony wskaźnik interfejsu dostarczony przez hostowaną kontrolkę.

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

Parametry

Riid
[in] Identyfikator interfejsu żądanego formantu.

ppvObject
[out] Adres wskaźnika, który otrzyma określony interfejs utworzonej kontrolki.

Wartość zwracana

Standardowa wartość HRESULT.

IAxWinHostWindow::SetExternalDispatch

Ustawia zewnętrzny dispinterface, który jest dostępny dla zawartych kontrolek za pośrednictwem metody IDocHostUIHandlerDispatch::GetExternal .

STDMETHOD(SetExternalDispatch)(IDispatch* pDisp);

Parametry

pDisp
[in] Wskaźnik do interfejsu IDispatch .

Wartość zwracana

Standardowa wartość HRESULT.

IAxWinHostWindow::SetExternalUIHandler

Wywołaj tę funkcję, aby ustawić zewnętrzny interfejs IDocHostUIHandlerDispatch dla CAxWindow obiektu.

STDMETHOD(SetExternalUIHandler)(IDocHostUIHandlerDispatch* pDisp);

Parametry

pDisp
[in] Wskaźnik do interfejsu IDocHostUIHandlerDispatch .

Wartość zwracana

Standardowa wartość HRESULT.

Uwagi

Ta funkcja jest używana przez kontrolki (takie jak kontrolka przeglądarki sieci Web), które wysyłają zapytanie do witryny hosta dla interfejsu IDocHostUIHandlerDispatch .

Zobacz też

Interfejs IAxWinAmbientDispatch
CAxWindow::QueryHost
AtlAxGetHost