IAxWinHostWindow Arabirimi

Bu arabirim, bir denetimi ve onun konak nesnesini işlemek için yöntemler sağlar.

Önemli

Bu sınıf ve üyeleri Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz.

Sözdizimi

interface IAxWinHostWindow : IUnknown

Üyeler

Yöntemler

Veri Akışı Adı	Açıklama
AttachControl	Konak nesnesine var olan bir denetimi ekler.
CreateControl	Bir denetim oluşturur ve konak nesnesine ekler.
CreateControlEx	Bir denetim oluşturur, konak nesnesine ekler ve isteğe bağlı olarak bir olay işleyicisi ayarlar.
QueryControl	Barındırılan denetim için bir arabirim işaretçisi döndürür.
SetExternalDispatch	Dış IDispatch arabirimi ayarlar.
SetExternalUIHandler	Dış IDocHostUIHandlerDispatch arabirimi ayarlar.

Açıklamalar

Bu arabirim, ATL'nin ActiveX denetimi barındırma nesneleri tarafından kullanıma sunulur. Konak nesnesine denetim oluşturmak ve/veya eklemek, barındırılan bir denetimden arabirim almak veya Web tarayıcısını barındırırken kullanılacak dış dispinterface veya UI işleyicisini ayarlamak için bu arabirimdeki yöntemleri çağırın.

Gereksinimler

Bu arabirimin tanımı, aşağıda gösterildiği gibi IDL veya C++olarak kullanılabilir.

Tanım türü	Dosya
IDL	ATLIFace.idl
C++	ATLIFace.h (ATLBase.h'de de bulunur)

IAxWinHostWindow::AttachControl

hWnd tarafından tanımlanan pencereyi kullanarak konak nesnesine mevcut (ve daha önce başlatılan) bir denetim ekler.

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

Parametreler

pUnkControl
[in] Konak nesnesine IUnknown eklenecek denetimin arabirimine ilişkin bir işaretçi.

hWnd
[in] Barındırma için kullanılacak pencerenin tutamacı.

Dönüş Değeri

Standart bir HRESULT değeri.

IAxWinHostWindow::CreateControl

Bir denetim oluşturur, başlatır ve hWnd tarafından tanımlanan pencerede barındırılır.

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

Parametreler

lpTricsData
[in] Oluşturulacak denetimi tanımlayan bir dize. CLSID (küme ayraçlarını içermelidir), ProgID, URL veya ham HTML (MSHTML: ön ekini içerir) olabilir.

hWnd
[in] Barındırma için kullanılacak pencerenin tutamacı.

pStream
[in] Denetim için başlatma verilerini içeren bir akış için arabirim işaretçisi. NULL olabilir.

Dönüş Değeri

Standart bir HRESULT değeri.

Açıklamalar

Bu pencere, iletilerin denetime yansıtılabilmesi ve diğer kapsayıcı özelliklerinin çalışması için bu arabirimi gösteren konak nesnesi tarafından alt sınıfa alınacaktır.

Bu yöntemi çağırmak, IAxWinHostWindow::CreateControlEx çağrısıyla eşdeğerdir.

Lisanslı bir ActiveX denetimi oluşturmak için bkz . IAxWinHostWindowLic::CreateControlLic.

IAxWinHostWindow::CreateControlEx

IAxWinHostWindow::CreateControl gibi bir ActiveX denetimi oluşturur, bunu başlatır ve belirtilen pencerede barındırabilir.

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

Parametreler

lpTricsData
[in] Oluşturulacak denetimi tanımlayan bir dize. CLSID (küme ayraçlarını içermelidir), ProgID, URL veya ham HTML (MSHTML: ön ekli) olabilir.

hWnd
[in] Barındırma için kullanılacak pencerenin tutamacı.

pStream
[in] Denetim için başlatma verilerini içeren bir akış için arabirim işaretçisi. NULL olabilir.

ppUnk
[out] Oluşturulan denetimin arabirimini IUnknown alacak bir işaretçinin adresi. NULL olabilir.

riidAdvise
[in] İçerilen nesnedeki giden arabirimin arabirim tanımlayıcısı. IID_NULL olabilir.

punkAdvise
[in] tarafından iidSinkbelirtilen kapsanan nesnedeki bağlantı noktasına bağlanacak havuz nesnesinin arabirimine yönelik bir işaretçiIUnknown.

Dönüş Değeri

Standart bir HRESULT değeri.

Açıklamalar

yönteminden CreateControl farklı olarak, CreateControlEx yeni oluşturulan denetim için bir arabirim işaretçisi almanıza ve denetim tarafından tetiklenen olayları almak için bir olay havuzu ayarlamanıza da olanak tanır.

Lisanslı bir ActiveX denetimi oluşturmak için bkz . IAxWinHostWindowLic::CreateControlLicEx.

IAxWinHostWindow::QueryControl

Barındırılan denetim tarafından sağlanan belirtilen arabirim işaretçisini döndürür.

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

Parametreler

riid
[in] İstenen denetimdeki bir arabirimin kimliği.

ppvObject
[out] Oluşturulan denetimin belirtilen arabirimini alacak bir işaretçinin adresi.

Dönüş Değeri

Standart bir HRESULT değeri.

IAxWinHostWindow::SetExternalDispatch

IDocHostUIHandlerDispatch::GetExternal yöntemi aracılığıyla kapsanan denetimler için kullanılabilen dış dispinterface'i ayarlar.

STDMETHOD(SetExternalDispatch)(IDispatch* pDisp);

Parametreler

pDisp
[in] Arabirim işaretçisi IDispatch .

Dönüş Değeri

Standart bir HRESULT değeri.

IAxWinHostWindow::SetExternalUIHandler

Nesnenin dış IDocHostUIHandlerDispatch arabirimini ayarlamak için bu işlevi çağırın CAxWindow .

STDMETHOD(SetExternalUIHandler)(IDocHostUIHandlerDispatch* pDisp);

Parametreler

pDisp
[in] Arabirim işaretçisi IDocHostUIHandlerDispatch .

Dönüş Değeri

Standart bir HRESULT değeri.

Açıklamalar

Bu işlev, arabirimi için IDocHostUIHandlerDispatch konağın sitesini sorgulayan denetimler (Web tarayıcısı denetimi gibi) tarafından kullanılır.

Ayrıca bkz.

IAxWinAmbientDispatch Arabirimi
CAxWindow::QueryHost
AtlAxGetHost