CDHtmlDialog Kelas

Digunakan untuk membuat kotak dialog yang menggunakan HTML daripada sumber daya dialog untuk mengimplementasikan antarmuka pengguna mereka.

Sintaks

class CDHtmlDialog : public CDialog, public CDHtmlEventSink

Anggota

Konstruktor Publik

Nama	Deskripsi
CDHtmlDialog::CDHtmlDialog	Membuat objek CDHtmlDialog.
CDHtmlDialog::~CDHtmlDialog	Menghancurkan objek CDHtmlDialog.

Metode Publik

Nama	Deskripsi
CDHtmlDialog::CanAccessExternal	Dapat diambil alih yang disebut sebagai pemeriksaan akses untuk melihat apakah objek skrip pada halaman yang dimuat dapat mengakses pengiriman eksternal situs kontrol. Pemeriksaan untuk memastikan pengiriman aman untuk pembuatan skrip atau zona saat ini memungkinkan objek yang tidak aman untuk pembuatan skrip.
CDHtmlDialog::CreateControlSite	Dapat diganti digunakan untuk membuat instans situs kontrol untuk menghosting kontrol WebBrowser pada dialog.
CDHtmlDialog::DDX_DHtml_AxControl	Bertukar data antara variabel anggota dan nilai properti kontrol ActiveX pada halaman HTML.
CDHtmlDialog::DDX_DHtml_CheckBox	Bertukar data antara variabel anggota dan kotak centang di halaman HTML.
CDHtmlDialog::DDX_DHtml_ElementText	Bertukar data antara variabel anggota dan properti elemen HTML apa pun di halaman HTML.
CDHtmlDialog::DDX_DHtml_Radio	Bertukar data antara variabel anggota dan tombol radio di halaman HTML.
CDHtmlDialog::DDX_DHtml_SelectIndex	Mendapatkan atau mengatur indeks kotak daftar di halaman HTML.
CDHtmlDialog::DDX_DHtml_SelectString	Mendapatkan atau mengatur teks tampilan entri kotak daftar (berdasarkan indeks saat ini) pada halaman HTML.
CDHtmlDialog::DDX_DHtml_SelectValue	Mendapatkan atau mengatur nilai entri kotak daftar (berdasarkan indeks saat ini) pada halaman HTML.
CDHtmlDialog::DestroyModeless	Menghancurkan kotak dialog tanpa mode.
CDHtmlDialog::EnableModeless	Mengaktifkan kotak dialog tanpa mode.
CDHtmlDialog::FilterDataObject	Memungkinkan dialog untuk memfilter objek data clipboard yang dibuat oleh browser yang dihosting.
CDHtmlDialog::GetControlDispatch	IDispatch Mengambil antarmuka pada kontrol ActiveX yang disematkan dalam dokumen HTML.
CDHtmlDialog::GetControlProperty	Mengambil properti yang diminta dari kontrol ActiveX yang ditentukan.
CDHtmlDialog::GetCurrentUrl	Mengambil Uniform Resource Locator (URL) yang terkait dengan dokumen saat ini.
CDHtmlDialog::GetDHtmlDocument	IHTMLDocument2 Mengambil antarmuka pada dokumen HTML yang saat ini dimuat.
CDHtmlDialog::GetDropTarget	Dipanggil oleh kontrol WebBrowser yang terkandung saat digunakan sebagai target penurunan untuk memungkinkan dialog menyediakan alternatif IDropTarget.
CDHtmlDialog::GetElement	Mendapatkan antarmuka pada elemen HTML.
CDHtmlDialog::GetElementHtml	Mengambil innerHTML properti elemen HTML.
CDHtmlDialog::GetElementInterface	Mengambil penunjuk antarmuka yang diminta dari elemen HTML.
CDHtmlDialog::GetElementProperty	Mengambil nilai properti elemen HTML.
CDHtmlDialog::GetElementText	Mengambil innerText properti elemen HTML.
CDHtmlDialog::GetEvent	Mendapatkan penunjuk IHTMLEventObj ke objek peristiwa saat ini.
CDHtmlDialog::GetExternal	Mendapatkan antarmuka host IDispatch .
CDHtmlDialog::GetHostInfo	Mengambil kemampuan UI host.
CDHtmlDialog::GetOptionKeyPath	Mengambil kunci registri tempat preferensi pengguna disimpan.
CDHtmlDialog::HideUI	Menyembunyikan UI host.
CDHtmlDialog::IsExternalDispatchSafe	Menunjukkan apakah antarmuka host IDispatch aman untuk pembuatan skrip.
CDHtmlDialog::LoadFromResource	Memuat sumber daya yang ditentukan ke dalam kontrol WebBrowser.
CDHtmlDialog::Navigate	Menavigasi ke URL yang ditentukan.
CDHtmlDialog::OnBeforeNavigate	Dipanggil oleh kerangka kerja sebelum peristiwa navigasi diaktifkan.
CDHtmlDialog::OnDocumentComplete	Dipanggil oleh kerangka kerja untuk memberi tahu aplikasi ketika dokumen telah mencapai status READYSTATE_COMPLETE .
CDHtmlDialog::OnDocWindowActivate	Dipanggil oleh kerangka kerja saat jendela dokumen diaktifkan atau dinonaktifkan.
CDHtmlDialog::OnFrameWindowActivate	Dipanggil oleh kerangka kerja ketika jendela bingkai diaktifkan atau dinonaktifkan.
CDHtmlDialog::OnInitDialog	Dipanggil sebagai respons terhadap WM_INITDIALOG pesan.
CDHtmlDialog::OnNavigateComplete	Dipanggil oleh kerangka kerja setelah peristiwa navigasi selesai.
CDHtmlDialog::ResizeBorder	Memperingatkan objek yang diperlukan untuk mengubah ukuran ruang batasnya.
CDHtmlDialog::SetControlProperty	Mengatur properti kontrol ActiveX ke nilai baru.
CDHtmlDialog::SetElementHtml	innerHTML Mengatur properti elemen HTML.
CDHtmlDialog::SetElementProperty	Mengatur properti elemen HTML.
CDHtmlDialog::SetElementText	innerText Mengatur properti elemen HTML.
CDHtmlDialog::SetExternalDispatch	Mengatur antarmuka host IDispatch .
CDHtmlDialog::SetHostFlags	Mengatur bendera UI host.
CDHtmlDialog::ShowContextMenu	Dipanggil saat menu konteks akan ditampilkan.
CDHtmlDialog::ShowUI	Menampilkan UI host.
CDHtmlDialog::TranslateAccelerator	Dipanggil untuk memproses pesan akselerator-kunci menu.
CDHtmlDialog::TranslateUrl	Dipanggil untuk mengubah URL yang akan dimuat.
CDHtmlDialog::UpdateUI	Dipanggil untuk memberi tahu host bahwa status perintah telah berubah.

Anggota Data Publik

Nama	Deskripsi
CDHtmlDialog::m_bUseHtmlTitle	Menunjukkan apakah akan menggunakan judul dokumen HTML sebagai keterangan dialog.
CDHtmlDialog::m_nHtmlResID	ID sumber daya sumber daya HTML yang akan ditampilkan.
CDHtmlDialog::m_pBrowserApp	Penunjuk ke aplikasi browser Web.
CDHtmlDialog::m_spHtmlDoc	Penunjuk ke dokumen HTML.
CDHtmlDialog::m_strCurrentUrl	URL saat ini.
CDHtmlDialog::m_szHtmlResID	Versi string ID sumber daya HTML.

Keterangan

CDHtmlDialog dapat memuat HTML yang akan ditampilkan dari sumber daya HTML atau URL.

CDHtmlDialog juga dapat melakukan pertukaran data dengan kontrol HTML dan menangani peristiwa dari kontrol HTML, seperti klik tombol.

Hierarki Warisan

CObject

CDHtmlSinkHandlerBase2

CDHtmlSinkHandlerBase1

CCmdTarget

CDHtmlSinkHandler

CWnd

CDHtmlEventSink

CDialog

CDHtmlDialog

Persyaratan

Header: afxdhtml.h

DDX_DHtml Makro Pembantu

Makro DDX_DHtml pembantu memungkinkan akses mudah ke properti kontrol yang umum digunakan pada halaman HTML.

Makro Pertukaran Data

Nama	Deskripsi
DDX_DHtml_ElementValue	Mengatur atau mengambil properti Nilai dari kontrol yang dipilih.
DDX_DHtml_ElementInnerText	Mengatur atau mengambil teks antara tag awal dan akhir elemen saat ini.
DDX_DHtml_ElementInnerHtml	Mengatur atau mengambil HTML antara tag awal dan akhir elemen saat ini.
DDX_DHtml_Anchor_Href	Mengatur atau mengambil URL tujuan atau titik jangkar.
DDX_DHtml_Anchor_Target	Mengatur atau mengambil jendela atau bingkai target.
DDX_DHtml_Img_Src	Mengatur atau mengambil nama gambar atau klip video dalam dokumen.
DDX_DHtml_Frame_Src	Mengatur atau mengambil URL bingkai terkait.
DDX_DHtml_IFrame_Src	Mengatur atau mengambil URL bingkai terkait.

CDHtmlDialog::CanAccessExternal

Dapat diambil alih yang disebut sebagai pemeriksaan akses untuk melihat apakah objek skrip pada halaman yang dimuat dapat mengakses pengiriman eksternal situs kontrol. Pemeriksaan untuk memastikan pengiriman aman untuk pembuatan skrip atau zona saat ini memungkinkan objek yang tidak aman untuk pembuatan skrip.

virtual BOOL CanAccessExternal();

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

CDHtmlDialog::CDHtmlDialog

Membuat kotak dialog HTML dinamis berbasis sumber daya.

CDHtmlDialog();

CDHtmlDialog(
    LPCTSTR lpszTemplateName,
    LPCTSTR szHtmlResID,
    CWnd *pParentWnd = NULL);

CDHtmlDialog(
    UINT nIDTemplate,
    UINT nHtmlResID = 0,
    CWnd *pParentWnd = NULL);

Parameter

lpszTemplateName
String yang dihentikan null yang merupakan nama sumber daya templat kotak dialog.

szHtmlResID
String yang dihentikan null yang merupakan nama sumber daya HTML.

pParentWnd
Penunjuk ke objek jendela induk atau pemilik (jenis CWnd) tempat objek dialog berada. Jika , NULLjendela induk objek dialog diatur ke jendela aplikasi utama.

nIDTemplate
Berisi nomor ID sumber daya templat kotak dialog.

nHtmlResID
Berisi nomor ID sumber daya HTML.

Keterangan

Bentuk kedua konstruktor menyediakan akses ke sumber daya dialog melalui nama templat. Bentuk ketiga konstruktor menyediakan akses ke sumber daya dialog melalui ID templat sumber daya. Biasanya, ID dimulai dengan awalan IDD_ .

CDHtmlDialog::~CDHtmlDialog

Menghancurkan objek CDHtmlDialog .

virtual ~CDHtmlDialog();

Keterangan

Fungsi CWnd::DestroyWindow anggota harus digunakan untuk menghancurkan kotak dialog modeless yang dibuat oleh CDialog::Create.

CDHtmlDialog::CreateControlSite

Dapat diganti digunakan untuk membuat instans situs kontrol untuk menghosting kontrol WebBrowser pada dialog.

virtual BOOL CreateControlSite(
    COleControlContainer* pContainer,
    COleControlSite** ppSite,
    UINT /* nID */,
    REFCLSID /* clsid */);

Parameter

pContainer
Penunjuk ke COleControlContainer objek.

ppSite
Penunjuk ke penunjuk ke COleControlSite.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Anda dapat mengambil alih fungsi anggota ini untuk mengembalikan instans kelas situs kontrol Anda sendiri.

CDHtmlDialog::DDX_DHtml_AxControl

Bertukar data antara variabel anggota dan nilai properti kontrol ActiveX pada halaman HTML.

void DDX_DHtml_AxControl(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    VARIANT& var);

void DDX_DHtml_AxControl(
    CDataExchange* pDX,
    LPCTSTR szId,
    LPCTSTR szPropName,
    VARIANT& var);

Parameter

pDX
Penunjuk ke CDataExchange objek.

szId
Nilai parameter ID tag objek di sumber HTML untuk kontrol ActiveX.

dispId
ID pengiriman properti yang ingin Anda tukarkan datanya.

szPropName
Nama properti.

var
Anggota data, dari jenis VARIANT, , COleVariantatau CComVariant, yang menyimpan nilai yang ditukar dengan properti kontrol ActiveX.

Contoh

// COleVariant m_varSliderValue;
DDX_DHtml_AxControl(pDX, _T("slider1"), 0x0b /* Value */, m_varSliderValue);

CDHtmlDialog::DDX_DHtml_CheckBox

Bertukar data antara variabel anggota dan kotak centang di halaman HTML.

void DDX_DHtml_CheckBox(
    CDataExchange* pDX,
    LPCTSTR szId,
    int& value);

Parameter

pDX
Penunjuk ke CDataExchange objek.

szId
Nilai yang Anda tentukan untuk parameter ID kontrol HTML.

value
Nilai yang sedang ditukar.

Contoh

// int m_nItalic;
DDX_DHtml_CheckBox(pDX, L"italic", m_nItalic);

CDHtmlDialog::DDX_DHtml_ElementText

Bertukar data antara variabel anggota dan properti elemen HTML apa pun di halaman HTML.

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    CString& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    short& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    int& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    long& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    DWORD& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    float& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    double& value);

Parameter

pDX
Penunjuk ke CDataExchange objek.

szId
Nilai yang Anda tentukan untuk parameter ID kontrol HTML.

dispId
ID pengiriman elemen HTML yang ingin Anda tukarkan datanya.

value
Nilai yang sedang ditukar.

CDHtmlDialog::DDX_DHtml_Radio

Bertukar data antara variabel anggota dan tombol radio di halaman HTML.

void DDX_DHtml_Radio(
    CDataExchange* pDX,
    LPCTSTR szId,
    long& value);

Parameter

pDX
Penunjuk ke CDataExchange objek.

szId
Nilai yang Anda tentukan untuk parameter ID kontrol HTML.

value
Nilai yang sedang ditukar.

CDHtmlDialog::DDX_DHtml_SelectIndex

Mendapatkan atau mengatur indeks kotak daftar di halaman HTML.

void DDX_DHtml_SelectIndex(
    CDataExchange* pDX,
    LPCTSTR szId,
    long& value);

Parameter

pDX
Penunjuk ke CDataExchange objek.

szId
Nilai yang Anda tentukan untuk parameter kontrol id HTML.

value
Nilai yang sedang ditukar.

CDHtmlDialog::DDX_DHtml_SelectString

Mendapatkan atau mengatur teks tampilan entri kotak daftar (berdasarkan indeks saat ini) pada halaman HTML.

void DDX_DHtml_SelectString(
    CDataExchange* pDX,
    LPCTSTR szId,
    CString& value);

Parameter

pDX
Penunjuk ke CDataExchange objek.

szId
Nilai yang Anda tentukan untuk parameter ID kontrol HTML.

value
Nilai yang sedang ditukar.

CDHtmlDialog::DDX_DHtml_SelectValue

Mendapatkan atau mengatur nilai entri kotak daftar (berdasarkan indeks saat ini) pada halaman HTML.

void DDX_DHtml_SelectValue(
    CDataExchange* pDX,
    LPCTSTR szId,
    CString& value);

Parameter

pDX
Penunjuk ke CDataExchange objek.

szId
Nilai yang Anda tentukan untuk parameter ID kontrol HTML.

value
Nilai yang sedang ditukar.

Contoh

// CString m_strBlurDir;
DDX_DHtml_SelectValue(pDX, L"blurDir", m_strBlurDir);

CDHtmlDialog::DestroyModeless

Mencopot kotak dialog tanpa mode dari CDHtmlDialog objek dan menghancurkan objek.

void DestroyModeless();

CDHtmlDialog::EnableModeless

Mengaktifkan kotak dialog tanpa mode.

STDMETHOD(EnableModeless)(BOOL fEnable);

Parameter

fEnable
Lihat fEnable di IDocHostUIHandler::EnableModeless Windows SDK.

Tampilkan Nilai

Menampilkan E_NOTIMPL.

Keterangan

Fungsi anggota ini adalah CDHtmlDialog implementasi dari IDocHostUIHandler::EnableModeless, seperti yang dijelaskan dalam Windows SDK.

CDHtmlDialog::FilterDataObject

Memungkinkan dialog untuk memfilter objek data clipboard yang dibuat oleh browser yang dihosting.

STDMETHOD(FilterDataObject)(
    IDataObject* pDO,
    IDataObject** ppDORet);

Parameter

pDO
Lihat pDO di IDocHostUIHandler::FilterDataObject Windows SDK.

ppDORet
Lihat ppDORet di IDocHostUIHandler::FilterDataObject Windows SDK.

Tampilkan Nilai

Menampilkan S_FALSE.

Keterangan

Fungsi anggota ini adalah CDHtmlDialog implementasi dari IDocHostUIHandler::FilterDataObject, seperti yang dijelaskan dalam Windows SDK.

CDHtmlDialog::GetControlDispatch

IDispatch Mengambil antarmuka pada kontrol ActiveX yang disematkan dalam dokumen HTML yang dikembalikan oleh GetDHtmlDocument.

HRESULT GetControlDispatch(
    LPCTSTR szId,
    IDispatch** ppdisp);

Parameter

szId
ID HTML kontrol ActiveX.

ppdisp
Antarmuka IDispatch kontrol jika ditemukan di halaman Web.

Tampilkan Nilai

Nilai standar HRESULT .

CDHtmlDialog::GetControlProperty

Mengambil properti yang diminta dari kontrol ActiveX yang ditentukan.

VARIANT GetControlProperty(
    LPCTSTR szId,
    LPCTSTR szPropName);

VARIANT GetControlProperty(
    LPCTSTR szId,
    DISPID dispId);

VARIANT GetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId);

Parameter

szId
ID HTML kontrol ActiveX.

szPropName
Nama properti di lokal default pengguna saat ini.

pdispControl
Penunjuk IDispatch kontrol ActiveX.

dispId
ID pengiriman properti.

Tampilkan Nilai

Varian yang berisi properti yang diminta atau varian kosong jika kontrol atau properti tidak dapat ditemukan.

Keterangan

Kelebihan beban tercantum dari paling tidak efisien di bagian atas hingga paling efisien di bagian bawah.

CDHtmlDialog::GetCurrentUrl

Mengambil Uniform Resource Locator (URL) yang terkait dengan dokumen saat ini.

void GetCurrentUrl(CString& szUrl);

Parameter

szUrl
Objek CString yang berisi URL untuk diambil.

CDHtmlDialog::GetDHtmlDocument

IHTMLDocument2 Mengambil antarmuka pada dokumen HTML yang saat ini dimuat.

HRESULT GetDHtmlDocument(IHTMLDocument2 **pphtmlDoc);

Parameter

**pphtmlDoc Penunjuk ke penunjuk ke dokumen HTML.

Tampilkan Nilai

HRESULTStandar . Mengembalikan S_OK jika berhasil.

CDHtmlDialog::GetDropTarget

Dipanggil oleh kontrol WebBrowser yang terkandung saat digunakan sebagai target penurunan untuk memungkinkan dialog menyediakan alternatif IDropTarget.

STDMETHOD(GetDropTarget)(
    IDropTarget* pDropTarget,
    IDropTarget** ppDropTarget);

Parameter

pDropTarget
Lihat pDropTarget di IDocHostUIHandler::GetDropTarget Windows SDK.

ppDropTarget
Lihat ppDropTarget di IDocHostUIHandler::GetDropTarget Windows SDK.

Tampilkan Nilai

Menampilkan E_NOTIMPL.

Keterangan

Fungsi anggota ini adalah CDHtmlDialog implementasi dari IDocHostUIHandler::GetDropTarget, seperti yang dijelaskan dalam Windows SDK.

CDHtmlDialog::GetElement

Mengembalikan antarmuka pada elemen HTML yang ditentukan oleh szElementId.

HRESULT GetElement(
    LPCTSTR szElementId,
    IDispatch** ppdisp,
    BOOL* pbCollection = NULL);

HRESULT GetElement(
    LPCTSTR szElementId,
    IHTMLElement** pphtmlElement);

Parameter

szElementId
ID elemen HTML.

ppdisp
Penunjuk IDispatch ke elemen atau kumpulan elemen yang diminta.

pbCollection
Menunjukkan BOOL apakah objek yang diwakili oleh ppdisp adalah elemen tunggal atau kumpulan elemen.

pphtmlElement
Penunjuk IHTMLElement ke elemen yang diminta.

Tampilkan Nilai

Nilai standar HRESULT .

Keterangan

Gunakan kelebihan beban pertama jika Anda perlu menangani kondisi di mana mungkin ada lebih dari satu elemen dengan ID yang ditentukan. Anda dapat menggunakan parameter terakhir untuk mengetahui apakah penunjuk antarmuka yang dikembalikan adalah ke koleksi atau satu item. Jika penunjuk antarmuka ada di koleksi, Anda dapat mengkueri IHTMLElementCollection dan menggunakan propertinya item untuk merujuk ke elemen berdasarkan posisi ordinal.

Kelebihan beban kedua akan gagal jika ada lebih dari satu elemen dengan ID yang sama di halaman.

CDHtmlDialog::GetElementHtml

Mengambil innerHTML properti elemen HTML yang diidentifikasi oleh szElementId.

BSTR GetElementHtml(LPCTSTR szElementId);

Parameter

szElementId
ID elemen HTML.

Tampilkan Nilai

Properti innerHTML elemen HTML yang diidentifikasi oleh szElementId atau NULL jika elemen tidak dapat ditemukan.

CDHtmlDialog::GetElementInterface

Mengambil penunjuk antarmuka yang diminta dari elemen HTML yang diidentifikasi oleh szElementId.

template <class Q> HRESULT GetElementInterface(
    LPCTSTR szElementId,
    Q** ppvObj);

HRESULT GetElementInterface(
    LPCTSTR szElementId,
    REFIID refiid,
    void** ppvObj);

Parameter

szElementId
ID elemen HTML.

ppvObj
Alamat penunjuk yang akan diisi dengan penunjuk antarmuka yang diminta jika elemen ditemukan dan kueri berhasil.

refiid
ID antarmuka (IID) antarmuka yang diminta.

Tampilkan Nilai

Nilai standar HRESULT .

Contoh

CComPtr<IHTMLInputButtonElement> spBtn1;
CComPtr<IHTMLInputButtonElement> spBtn2;
HRESULT hr = S_OK;

// Use the template overload
hr = GetElementInterface(L"Button1", &spBtn1);

// Use the nontemplate overload
hr = GetElementInterface(L"Button1", IID_IHTMLInputButtonElement,
                         reinterpret_cast<void **>(&spBtn2));

CDHtmlDialog::GetElementProperty

Mengambil nilai properti yang diidentifikasi oleh dispId dari elemen HTML yang diidentifikasi oleh szElementId.

VARIANT GetElementProperty(
    LPCTSTR szElementId,
    DISPID dispId);

Parameter

szElementId
ID elemen HTML.

dispId
ID pengiriman properti.

Tampilkan Nilai

Nilai properti atau varian kosong jika properti atau elemen tidak dapat ditemukan.

CDHtmlDialog::GetElementText

Mengambil innerText properti elemen HTML yang diidentifikasi oleh szElementId.

BSTR GetElementText(LPCTSTR szElementId);

Parameter

szElementId
ID elemen HTML.

Tampilkan Nilai

Properti innerText elemen HTML yang diidentifikasi oleh szElementId atau NULL jika properti atau elemen tidak dapat ditemukan.

CDHtmlDialog::GetEvent

Mengembalikan penunjuk IHTMLEventObj ke objek peristiwa saat ini.

HRESULT GetEvent(IHTMLEventObj** ppEventObj);

Parameter

ppEventObj
Alamat pointer yang akan diisi dengan IHTMLEventObj penunjuk antarmuka.

Tampilkan Nilai

Nilai standar HRESULT .

Keterangan

Fungsi ini hanya boleh dipanggil dari dalam penanganan aktivitas DHTML.

CDHtmlDialog::GetExternal

Mendapatkan antarmuka host IDispatch .

STDMETHOD(GetExternal)(IDispatch** ppDispatch);

Parameter

ppDispatch
Lihat ppDispatch di IDocHostUIHandler::GetExternal Windows SDK.

Tampilkan Nilai

Mengembalikan S_OK keberhasilan atau E_NOTIMPL kegagalan.

Keterangan

Fungsi anggota ini adalah CDHtmlDialog implementasi dari IDocHostUIHandler::GetExternal, seperti yang dijelaskan dalam Windows SDK.

CDHtmlDialog::GetHostInfo

Mengambil kemampuan UI host.

STDMETHOD(GetHostInfo)(DOCHOSTUIINFO* pInfo);

Parameter

pInfo
Lihat pInfo di IDocHostUIHandler::GetHostInfo Windows SDK.

Tampilkan Nilai

Menampilkan S_OK.

Keterangan

Fungsi anggota ini adalah CDHtmlDialog implementasi dari IDocHostUIHandler::GetHostInfo, seperti yang dijelaskan dalam Windows SDK.

CDHtmlDialog::GetOptionKeyPath

Mengambil kunci registri tempat preferensi pengguna disimpan.

STDMETHOD(GetOptionKeyPath)(
    LPOLESTR* pchKey,
    DWORD dw);

Parameter

pchKey
Lihat pchKey di IDocHostUIHandler::GetOptionKeyPath Windows SDK.

dw
Lihat dw di IDocHostUIHandler::GetOptionKeyPath Windows SDK.

Tampilkan Nilai

Menampilkan E_NOTIMPL.

Keterangan

Fungsi anggota ini adalah CDHtmlDialog implementasi dari IDocHostUIHandler::GetOptionKeyPath, seperti yang dijelaskan dalam Windows SDK.

CDHtmlDialog::HideUI

Menyembunyikan UI host.

STDMETHOD(HideUI)(void);

Tampilkan Nilai

Menampilkan E_NOTIMPL.

Keterangan

Fungsi anggota ini adalah CDHtmlDialog implementasi dari IDocHostUIHandler::HideUI, seperti yang dijelaskan dalam Windows SDK.

CDHtmlDialog::IsExternalDispatchSafe

Menunjukkan apakah antarmuka host IDispatch aman untuk pembuatan skrip.

virtual BOOL IsExternalDispatchSafe();

Tampilkan Nilai

Menampilkan FALSE.

CDHtmlDialog::LoadFromResource

Memuat sumber daya yang ditentukan ke dalam kontrol WebBrowser dalam dialog DHTML.

BOOL LoadFromResource(LPCTSTR lpszResource);
BOOL LoadFromResource(UINT nRes);

Parameter

lpszResource
Penunjuk ke string yang berisi nama sumber daya yang akan dimuat.

nRes
ID sumber daya yang akan dimuat.

Tampilkan Nilai

TRUE jika berhasil; jika tidak FALSE.

CDHtmlDialog::m_bUseHtmlTitle

Menunjukkan apakah akan menggunakan judul dokumen HTML sebagai keterangan dialog.

BOOL m_bUseHtmlTitle;

Keterangan

Jika m_bUseHtmlTitle adalah TRUE, keterangan dialog diatur sama dengan judul dokumen HTML; jika tidak, keterangan dalam sumber daya dialog digunakan.

CDHtmlDialog::m_nHtmlResID

ID sumber daya sumber daya HTML yang akan ditampilkan.

UINT m_nHtmlResID;

Contoh

CDHtmlDialog mydialog(IDD_MYDHTMLDLG);
mydialog.m_nHtmlResID = IDR_HTML_MYDHTMLDLG;
mydialog.DoModal();

CDHtmlDialog::m_pBrowserApp

Penunjuk ke aplikasi browser Web.

CComPtr <IWebBrowser2> m_pBrowserApp;

CDHtmlDialog::m_spHtmlDoc

Penunjuk ke dokumen HTML.

CComPtr<IHTMLDocument2> m_spHtmlDoc;

CDHtmlDialog::m_strCurrentUrl

URL saat ini.

CString m_strCurrentUrl;

CDHtmlDialog::m_szHtmlResID

Versi string ID sumber daya HTML.

LPTSTR m_szHtmlResID;

Contoh

CDHtmlDialog mydialog(IDD_MYDHTMLDLG);
TCHAR szResID[] = _T("HTML_PAGE");
mydialog.m_szHtmlResID = szResID;
mydialog.DoModal();

CDHtmlDialog::Navigate

Navigasikan ke sumber daya yang diidentifikasi oleh URL yang ditentukan oleh lpszURL.

void Navigate(
    LPCTSTR lpszURL,
    DWORD dwFlags = 0,
    LPCTSTR lpszTargetFrameName = NULL,
    LPCTSTR lpszHeaders = NULL,
    LPVOID lpvPostData = NULL,
    DWORD dwPostDataLen = 0);

Parameter

lpszURL
Penunjuk ke string yang berisi URL yang akan ditargetkan.

dwFlags
Bendera variabel yang menentukan apakah akan menambahkan sumber daya ke daftar riwayat, apakah akan membaca ke cache atau menulis dari cache, dan apakah akan menampilkan sumber daya di jendela baru. Variabel dapat berupa kombinasi nilai yang ditentukan oleh BrowserNavConstants enumerasi.

lpszTargetFrameName
Penunjuk ke string yang berisi nama bingkai untuk menampilkan sumber daya.

lpszHeaders
Penunjuk ke nilai yang menentukan header HTTP untuk dikirim ke server. Header ini ditambahkan ke header Internet Explorer default. Header dapat menentukan informasi seperti tindakan yang diperlukan server, jenis data yang diteruskan ke server, atau kode status. Parameter ini diabaikan jika URL bukan URL HTTP.

lpvPostData
Pointer ke data untuk dikirim dengan transaksi HTTP POST. Misalnya, transaksi POST digunakan untuk mengirim data yang dikumpulkan oleh formulir HTML. Jika parameter ini tidak menentukan data posting apa pun, Navigate keluarkan transaksi HTTP GET. Parameter ini diabaikan jika URL bukan URL HTTP.

dwPostDataLen
Data yang akan dikirim dengan transaksi HTTP POST. Misalnya, transaksi POST digunakan untuk mengirim data yang dikumpulkan oleh formulir HTML. Jika parameter ini tidak menentukan data posting apa pun, Navigate keluarkan transaksi HTTP GET. Parameter ini diabaikan jika URL bukan URL HTTP.

CDHtmlDialog::OnBeforeNavigate

Dipanggil oleh kerangka kerja untuk menyebabkan peristiwa kebakaran sebelum navigasi terjadi.

virtual void OnBeforeNavigate(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parameter

pDisp
Penunjuk ke IDispatch objek.

szUrl
Penunjuk ke string yang berisi URL untuk dinavigasi.

CDHtmlDialog::OnDocumentComplete

Dipanggil oleh kerangka kerja untuk memberi tahu aplikasi ketika dokumen telah mencapai status READYSTATE_COMPLETE .

virtual void OnDocumentComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parameter

pDisp
Penunjuk ke IDispatch objek.

szUrl
Penunjuk ke string yang berisi URL yang dinavigasi.

CDHtmlDialog::OnDocWindowActivate

Dipanggil oleh kerangka kerja saat jendela dokumen diaktifkan atau dinonaktifkan.

STDMETHOD(OnDocWindowActivate)(BOOL fActivate);

Parameter

fActivate
Lihat fActivate di IDocHostUIHandler::OnDocWindowActivate Windows SDK.

Tampilkan Nilai

Menampilkan E_NOTIMPL.

Keterangan

Fungsi anggota ini adalah CDHtmlDialog implementasi dari IDocHostUIHandler::OnDocWindowActivate, seperti yang dijelaskan dalam Windows SDK.

CDHtmlDialog::OnFrameWindowActivate

Dipanggil oleh kerangka kerja ketika jendela bingkai diaktifkan atau dinonaktifkan.

STDMETHOD(OnFrameWindowActivate)(BOOL fActivate);

Parameter

fActivate
Lihat fActivate di IDocHostUIHandler::OnFrameWindowActivate Windows SDK.

Tampilkan Nilai

Menampilkan E_NOTIMPL.

Keterangan

Fungsi anggota ini adalah CDHtmlDialog implementasi dari IDocHostUIHandler::OnFrameWindowActivate, seperti yang dijelaskan dalam Windows SDK.

CDHtmlDialog::OnInitDialog

Dipanggil sebagai respons terhadap WM_INITDIALOG pesan.

virtual BOOL OnInitDialog();

Tampilkan Nilai

Implementasi default mengembalikan TRUE.

Keterangan

Pesan ini dikirim ke kotak dialog selama Createpanggilan , , CreateIndirectatau DoModal , yang terjadi segera sebelum kotak dialog ditampilkan.

Ambil alih fungsi anggota ini jika Anda perlu melakukan pemrosesan khusus saat kotak dialog diinisialisasi. Dalam versi yang ditimpa, pertama-tama panggil kelas OnInitDialog dasar tetapi abaikan nilai pengembaliannya. Anda biasanya akan kembali TRUE dari fungsi anggota yang ditimpa.

Windows memanggil OnInitDialog fungsi melalui prosedur kotak dialog global standar yang umum untuk semua kotak dialog Pustaka Kelas Microsoft Foundation, bukan melalui peta pesan Anda, sehingga Anda tidak memerlukan entri peta pesan untuk fungsi anggota ini.

CDHtmlDialog::OnNavigateComplete

Dipanggil oleh kerangka kerja setelah navigasi ke URL yang ditentukan selesai.

virtual void OnNavigateComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parameter

pDisp
Penunjuk ke IDispatch objek.

szUrl
Penunjuk ke string yang berisi URL yang dinavigasi.

CDHtmlDialog::ResizeBorder

Memperingatkan objek yang diperlukan untuk mengubah ukuran ruang batasnya.

STDMETHOD(ResizeBorder)(
    LPCRECT prcBorder,
    IOleInPlaceUIWindow* pUIWindow,
    BOOL fRameWindow);

Parameter

prcBorder
Lihat prcBorder di IDocHostUIHandler::ResizeBorder Windows SDK.

pUIWindow
Lihat pUIWindow di IDocHostUIHandler::ResizeBorder Windows SDK.

fFrameWindow
Lihat fFrameWindow di IDocHostUIHandler::ResizeBorder Windows SDK.

Tampilkan Nilai

Mengembalikan E_NOTIMPL.

CDHtmlDialog::SetControlProperty

Mengatur properti kontrol ActiveX ke nilai baru.

void SetControlProperty(
    LPCTSTR szElementId,
    DISPID dispId,
    VARIANT* pVar);

void SetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId,
    VARIANT* pVar);

void SetControlProperty(
    LPCTSTR szElementId,
    LPCTSTR szPropName,
    VARIANT* pVar);

Parameter

szElementId
ID HTML kontrol ActiveX.

dispId
ID pengiriman properti yang akan diatur.

pVar
Penunjuk ke yang VARIANT berisi nilai properti baru.

pdispControl
Penunjuk ke antarmuka kontrol IDispatch ActiveX.

szPropName
String yang berisi nama properti yang akan diatur.

CDHtmlDialog::SetElementHtml

innerHTML Mengatur properti elemen HTML.

void SetElementHtml(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementHtml(
    IUnknown* punkElem,
    BSTR bstrText);

Parameter

szElementId
ID elemen HTML.

bstrText
Nilai innerHTML baru properti.

punkElem
Penunjuk IUnknown elemen HTML.

CDHtmlDialog::SetElementProperty

Mengatur properti elemen HTML.

void SetElementProperty(
    LPCTSTR szElementId,
    DISPID dispId,
    VARIANT* pVar);

Parameter

szElementId
ID elemen HTML.

dispId
ID pengiriman properti yang akan diatur.

pVar
Nilai baru properti.

CDHtmlDialog::SetElementText

innerText Mengatur properti elemen HTML.

void SetElementText(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementText(
    IUnknown* punkElem,
    BSTR bstrText);

Parameter

szElementId
ID elemen HTML.

bstrText
Nilai innerText baru properti.

punkElem
Penunjuk IUnknown elemen HTML.

CDHtmlDialog::SetExternalDispatch

Mengatur antarmuka host IDispatch .

void SetExternalDispatch(IDispatch* pdispExternal);

Parameter

pdispExternal
Antarmuka baru IDispatch .

CDHtmlDialog::SetHostFlags

Mengatur bendera UI host.

void SetHostFlags(DWORD dwFlags);

Parameter

dwFlags
Untuk nilai yang mungkin, lihat DOCHOSTUIFLAG di Windows SDK.

CDHtmlDialog::ShowContextMenu

Dipanggil saat menu konteks akan ditampilkan.

STDMETHOD(ShowContextMenu)(
    DWORD dwID,
    POINT* ppt,
    IUnknown* pcmdtReserved,
    IDispatch* pdispReserved);

Parameter

dwID
Lihat dwID di IDocHostUIHandler::ShowContextMenu Windows SDK.

ppt
Lihat ppt di IDocHostUIHandler::ShowContextMenu Windows SDK.

pcmdtReserved
Lihat pcmdtReserved di IDocHostUIHandler::ShowContextMenu Windows SDK.

pdispReserved
Lihat pdispReserved di IDocHostUIHandler::ShowContextMenu Windows SDK.

Tampilkan Nilai

Menampilkan S_FALSE.

Keterangan

Fungsi anggota ini adalah CDHtmlDialog implementasi dari IDocHostUIHandler::ShowContextMenu, seperti yang dijelaskan dalam Windows SDK.

CDHtmlDialog::ShowUI

Menampilkan UI host.

STDMETHOD(ShowUI)(
    DWORD dwID,
    IOleInPlaceActiveObject* pActiveObject,
    IOleCommandTarget* pCommandTarget,
    IOleInPlaceFrame* pFrame,
    IOleInPlaceUIWindow* pDoc);

Parameter

dwID
Lihat dwID di IDocHostUIHandler::ShowUI Windows SDK.

pActiveObject
Lihat pActiveObject di IDocHostUIHandler::ShowUI Windows SDK.

pCommandTarget
Lihat pCommandTarget di IDocHostUIHandler::ShowUI Windows SDK.

pFrame
Lihat pFrame di IDocHostUIHandler::ShowUI Windows SDK.

pDoc
Lihat pDoc di IDocHostUIHandler::ShowUI Windows SDK.

Tampilkan Nilai

Menampilkan S_FALSE.

Keterangan

Fungsi anggota ini adalah CDHtmlDialog implementasi dari IDocHostUIHandler::ShowUI, seperti yang dijelaskan dalam Windows SDK.

CDHtmlDialog::TranslateAccelerator

Dipanggil untuk memproses pesan akselerator-kunci menu.

STDMETHOD(TranslateAccelerator)(
    LPMSG lpMsg,
    const GUID* pguidCmdGroup,
    DWORD nCmdID);

Parameter

lpMsg
Lihat lpMsg di IDocHostUIHandler::TranslateAccelerator Windows SDK.

pguidCmdGroup
Lihat pguidCmdGroup di IDocHostUIHandler::TranslateAccelerator Windows SDK.

nCmdID
Lihat nCmdID di IDocHostUIHandler::TranslateAccelerator Windows SDK.

Tampilkan Nilai

Menampilkan S_FALSE.

Keterangan

Fungsi anggota ini adalah CDHtmlDialog implementasi dari IDocHostUIHandler::TranslateAccelerator, seperti yang dijelaskan dalam Windows SDK.

CDHtmlDialog::TranslateUrl

Dipanggil untuk mengubah URL yang akan dimuat.

STDMETHOD(TranslateUrl)(
    DWORD dwTranslate,
    OLECHAR* pchURLIn,
    OLECHAR** ppchURLOut);

Parameter

dwTranslate
Lihat dwTranslate di IDocHostUIHandler::TranslateUrl Windows SDK.

pchURLIn
Lihat pchURLIn di IDocHostUIHandler::TranslateUrl Windows SDK.

ppchURLOut
Lihat ppchURLOut di IDocHostUIHandler::TranslateUrl Windows SDK.

Tampilkan Nilai

Menampilkan S_FALSE.

Keterangan

Fungsi anggota ini adalah CDHtmlDialog implementasi dari IDocHostUIHandler::TranslateUrl, seperti yang dijelaskan dalam Windows SDK.

CDHtmlDialog::UpdateUI

Dipanggil untuk memberi tahu host bahwa status perintah telah berubah.

STDMETHOD(UpdateUI)(void);

Tampilkan Nilai

Menampilkan E_NOTIMPL.

Keterangan

Fungsi anggota ini adalah CDHtmlDialog implementasi dari IDocHostUIHandler::UpdateUI, seperti yang dijelaskan dalam Windows SDK.

Lihat juga

Sampel MFC DHtmlExplore
DDX_DHtml Makro Pembantu
Bagan Hierarki