Antarmuka IAxWinHostWindow

Antarmuka ini menyediakan metode untuk memanipulasi kontrol dan objek hostnya.

Penting

Kelas ini dan anggotanya tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime.

Sintaks

interface IAxWinHostWindow : IUnknown

Anggota

Metode

Nama	Deskripsi
AttachControl	Melampirkan kontrol yang ada ke objek host.
CreateControl	Membuat kontrol dan melampirkannya ke objek host.
CreateControlEx	Membuat kontrol, melampirkannya ke objek host, dan secara opsional menyiapkan penanganan aktivitas.
QueryControl	Mengembalikan penunjuk antarmuka ke kontrol yang dihosting.
SetExternalDispatch	Mengatur antarmuka eksternal IDispatch .
SetExternalUIHandler	Mengatur antarmuka eksternal IDocHostUIHandlerDispatch .

Keterangan

Antarmuka ini diekspos oleh objek hosting kontrol ActiveX ATL. Panggil metode pada antarmuka ini untuk membuat dan/atau melampirkan kontrol ke objek host, untuk mendapatkan antarmuka dari kontrol yang dihosting, atau untuk mengatur dispinterface eksternal atau handler UI untuk digunakan saat menghosting browser Web.

Persyaratan

Definisi antarmuka ini tersedia sebagai IDL atau C++, seperti yang ditunjukkan di bawah ini.

Jenis definisi	File
IDL	ATLIFace.idl
C++	ATLIFace.h (juga termasuk dalam ATLBase.h)

IAxWinHostWindow::AttachControl

Melampirkan kontrol yang ada (dan sebelumnya diinisialisasi) ke objek host menggunakan jendela yang diidentifikasi oleh hWnd.

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

Parameter

pUnkControl
[di] Penunjuk ke IUnknown antarmuka kontrol yang akan dilampirkan ke objek host.

hWnd
[di] Handel ke jendela yang akan digunakan untuk hosting.

Tampilkan Nilai

Nilai HRESULT standar.

IAxWinHostWindow::CreateControl

Membuat kontrol, menginisialisasinya, dan menghostingnya di jendela yang diidentifikasi oleh hWnd.

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

Parameter

lpTricsData
[di] String yang mengidentifikasi kontrol yang akan dibuat. Dapat berupa CLSID (harus menyertakan kurung kurawal), ProgID, URL, atau HTML mentah (diawali oleh MSHTML:).

hWnd
[di] Handel ke jendela yang akan digunakan untuk hosting.

pStream
[di] Penunjuk antarmuka untuk aliran yang berisi data inisialisasi untuk kontrol. Bisa NULL.

Tampilkan Nilai

Nilai HRESULT standar.

Keterangan

Jendela ini akan disubkelas oleh objek host yang mengekspos antarmuka ini sehingga pesan dapat dicerminkan ke kontrol dan fitur kontainer lainnya akan berfungsi.

Memanggil metode ini setara dengan memanggil IAxWinHostWindow::CreateControlEx.

Untuk membuat kontrol ActiveX berlisensi, lihat IAxWinHostWindowLic::CreateControlLic.

IAxWinHostWindow::CreateControlEx

Membuat kontrol ActiveX, menginisialisasinya, dan menghostingnya di jendela yang ditentukan, mirip dengan IAxWinHostWindow::CreateControl.

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

Parameter

lpTricsData
[di] String yang mengidentifikasi kontrol yang akan dibuat. Dapat berupa CLSID (harus menyertakan kurung kurawal), ProgID, URL, atau HTML mentah (diawali dengan MSHTML:).

hWnd
[di] Handel ke jendela yang akan digunakan untuk hosting.

pStream
[di] Penunjuk antarmuka untuk aliran yang berisi data inisialisasi untuk kontrol. Bisa NULL.

ppUnk
[out] Alamat pointer yang akan menerima IUnknown antarmuka kontrol yang dibuat. Bisa NULL.

riidAdvise
[di] Pengidentifikasi antarmuka antarmuka keluar pada objek yang terkandung. Bisa IID_NULL.

punkAdvise
[di] Penunjuk ke IUnknown antarmuka objek sink yang akan disambungkan ke titik koneksi pada objek yang terkandung yang ditentukan oleh iidSink.

Tampilkan Nilai

Nilai HRESULT standar.

Keterangan

Tidak seperti metode , CreateControl CreateControlEx juga memungkinkan Anda untuk menerima penunjuk antarmuka ke kontrol yang baru dibuat dan menyiapkan sink peristiwa untuk menerima peristiwa yang dipicu oleh kontrol.

Untuk membuat kontrol ActiveX berlisensi, lihat IAxWinHostWindowLic::CreateControlLicEx.

IAxWinHostWindow::QueryControl

Mengembalikan penunjuk antarmuka yang ditentukan yang disediakan oleh kontrol yang dihosting.

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

Parameter

riid
[di] ID antarmuka pada kontrol yang diminta.

ppvObject
[out] Alamat penunjuk yang akan menerima antarmuka yang ditentukan dari kontrol yang dibuat.

Tampilkan Nilai

Nilai HRESULT standar.

IAxWinHostWindow::SetExternalDispatch

Mengatur dispinterface eksternal, yang tersedia untuk kontrol yang terkandung melalui metode IDocHostUIHandlerDispatch::GetExternal .

STDMETHOD(SetExternalDispatch)(IDispatch* pDisp);

Parameter

pDisp
[di] Penunjuk ke IDispatch antarmuka.

Tampilkan Nilai

Nilai HRESULT standar.

IAxWinHostWindow::SetExternalUIHandler

Panggil fungsi ini untuk mengatur antarmuka IDocHostUIHandlerDispatch eksternal untuk CAxWindow objek.

STDMETHOD(SetExternalUIHandler)(IDocHostUIHandlerDispatch* pDisp);

Parameter

pDisp
[di] Penunjuk ke IDocHostUIHandlerDispatch antarmuka.

Tampilkan Nilai

Nilai HRESULT standar.

Keterangan

Fungsi ini digunakan oleh kontrol (seperti kontrol browser Web) yang mengkueri situs host untuk IDocHostUIHandlerDispatch antarmuka.

Lihat juga

Antarmuka IAxWinAmbientDispatch
CAxWindow::QueryHost
AtlAxGetHost