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 iidSink
belirtilen 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