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
Elementy członkowskie
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