Bagikan melalui

CHtmlView kelas

  • Artikel

Menyediakan fungsionalitas kontrol WebBrowser dalam konteks arsitektur dokumen/tampilan MFC.

Sintaks

class CHtmlView : public CFormView

Anggota

Metode Publik

Nama Deskripsi
CHtmlView::Create Membuat kontrol WebBrowser.
CHtmlView::CreateControlSite Dapat diganti digunakan untuk membuat instans situs kontrol untuk menghosting kontrol pada formulir.
CHtmlView::ExecFormsCommand Menjalankan perintah yang ditentukan menggunakan IOleCommandTarget::Exec metode .
CHtmlView::ExecWB Menjalankan perintah.
CHtmlView::GetAddressBar Menentukan apakah bilah alamat objek Internet Explorer terlihat. (Kontrol WebBrowser mengabaikan; Internet Explorer saja.)
CHtmlView::GetApplication Mengambil objek aplikasi yang mewakili aplikasi yang berisi instans aplikasi Internet Explorer saat ini.
CHtmlView::GetBusy Mengambil nilai yang menunjukkan apakah unduhan atau aktivitas lain masih berlangsung.
CHtmlView::GetContainer Mengambil kontainer kontrol WebBrowser.
CHtmlView::GetFullName Mengambil nama lengkap, termasuk jalur, sumber daya yang ditampilkan di browser web. (Kontrol WebBrowser mengabaikan; Internet Explorer saja.)
CHtmlView::GetFullScreen Menunjukkan apakah kontrol WebBrowser beroperasi dalam mode layar penuh atau dalam mode jendela normal.
CHtmlView::GetHeight Mengambil tinggi jendela utama Internet Explorer.
CHtmlView::GetHtmlDocument Mengambil dokumen HTML aktif.
CHtmlView::GetLeft Mengambil koordinat layar tepi kiri jendela utama Internet Explorer.
CHtmlView::GetLocationName Mengambil nama sumber daya yang saat ini ditampilkan WebBrowser
CHtmlView::GetLocationURL Mengambil URL sumber daya yang saat ini ditampilkan WebBrowser.
CHtmlView::GetMenuBar Mengambil nilai yang menentukan apakah bilah menu terlihat.
CHtmlView::GetOffline Mengambil nilai yang menentukan apakah kontrol sedang offline.
CHtmlView::GetParentBrowser Mengambil penunjuk ke IDispatch antarmuka. Untuk informasi selengkapnya, lihat Menerapkan IDispatch Antarmuka.
CHtmlView::GetProperty Mengambil nilai properti saat ini yang terkait dengan objek yang diberikan.
CHtmlView::GetReadyState Mengambil status siap objek browser web.
CHtmlView::GetRegisterAsBrowser Menunjukkan apakah kontrol WebBrowser terdaftar sebagai browser tingkat atas untuk resolusi nama target.
CHtmlView::GetRegisterAsDropTarget Menunjukkan apakah kontrol WebBrowser terdaftar sebagai target penurunan untuk navigasi.
CHtmlView::GetSilent Menunjukkan apakah ada kotak dialog yang dapat ditampilkan.
CHtmlView::GetSource Kode sumber HTML halaman web.
CHtmlView::GetStatusBar Menunjukkan apakah bilah status Internet Explorer terlihat. (Kontrol WebBrowser mengabaikan; Internet Explorer saja.)
CHtmlView::GetTheaterMode Menunjukkan apakah kontrol WebBrowser berada dalam mode bioskop.
CHtmlView::GetToolBar Mengambil nilai yang menentukan apakah toolbar terlihat.
CHtmlView::GetTop Mengambil koordinat layar tepi atas jendela utama Internet Explorer.
CHtmlView::GetTopLevelContainer Mengambil nilai yang menunjukkan apakah objek saat ini adalah kontainer tingkat atas kontrol WebBrowser.
CHtmlView::GetType Mengambil nama jenis objek dokumen.
CHtmlView::GetVisible Mengambil nilai yang menunjukkan apakah objek terlihat atau tersembunyi.
CHtmlView::GetWidth Mengambil lebar jendela utama Internet Explorer.
CHtmlView::GoBack Menavigasi ke item sebelumnya dalam daftar riwayat.
CHtmlView::GoForward Menavigasi ke item berikutnya dalam daftar riwayat.
CHtmlView::GoHome Menavigasi ke beranda atau halaman mulai saat ini.
CHtmlView::GoSearch Menavigasi ke halaman pencarian saat ini.
CHtmlView::LoadFromResource Memuat sumber daya dalam kontrol WebBrowser.
CHtmlView::Navigate Menavigasi ke sumber daya yang diidentifikasi oleh URL.
CHtmlView::Navigate2 Navigasi ke sumber daya yang diidentifikasi oleh URL, atau ke file yang diidentifikasi oleh jalur lengkap.
CHtmlView::OnBeforeNavigate2 Dipanggil sebelum operasi navigasi terjadi di WebBrowser yang diberikan (pada elemen jendela atau frameset).
CHtmlView::OnCommandStateChange Dipanggil untuk memberi tahu aplikasi bahwa status perintah browser web yang diaktifkan telah berubah.
CHtmlView::OnDocumentComplete Dipanggil untuk memberi tahu aplikasi bahwa dokumen telah mencapai status READYSTATE_COMPLETE .
CHtmlView::OnDocWindowActivate Dipanggil dari implementasi Internet Explorer atau MSHTML dari IOleInPlaceActiveObject::OnDocWindowActivate, yang memberi tahu objek aktif di tempat ketika jendela dokumen kontainer diaktifkan atau dinonaktifkan.
CHtmlView::OnDownloadBegin Dipanggil untuk memberi tahu aplikasi bahwa operasi navigasi dimulai.
CHtmlView::OnDownloadComplete Dipanggil ketika operasi navigasi selesai, dihentikan, atau gagal.
CHtmlView::OnEnableModeless Dipanggil untuk mengaktifkan atau menonaktifkan kotak dialog tanpa mode saat kontainer membuat atau menghancurkan kotak dialog modal.
CHtmlView::OnFilterDataObject Dipanggil pada host oleh Internet Explorer atau MSHTML untuk memungkinkan host menggantikan objek data Internet Explorer atau MSHTML.
CHtmlView::OnFrameWindowActivate Dipanggil dari IOleInPlaceActiveObject::OnFrameWindowActivate untuk memberi tahu objek ketika jendela bingkai tingkat atas kontainer diaktifkan atau dinonaktifkan.
CHtmlView::OnFullScreen Dipanggil FullScreen ketika properti telah berubah.
CHtmlView::OnGetDropTarget Dipanggil oleh Internet Explorer atau MSHTML ketika digunakan sebagai target penurunan untuk memungkinkan host menyediakan alternatif IDropTarget.
CHtmlView::OnGetExternal Dipanggil oleh Internet Explorer atau MSHTML untuk mendapatkan antarmuka host IDispatch .
CHtmlView::OnGetHostInfo Mengambil kemampuan UI host Internet Explorer atau MSHTML.
CHtmlView::OnGetOptionKeyPath Mengembalikan kunci registri di mana Internet Explorer atau MSHTML menyimpan preferensi pengguna.
CHtmlView::OnHideUI Dipanggil ketika Internet Explorer atau MSHTML menghapus menu dan bilah alatnya.
CHtmlView::OnMenuBar Dipanggil MenuBar ketika properti telah berubah.
CHtmlView::OnNavigateComplete2 Dipanggil setelah navigasi ke hyperlink selesai (pada elemen jendela atau frameset).
CHtmlView::OnNavigateError Dipanggil oleh kerangka kerja jika navigasi ke hyperlink gagal.
CHtmlView::OnNewWindow2 Dipanggil saat jendela baru akan dibuat untuk menampilkan sumber daya.
CHtmlView::OnProgressChange Dipanggil untuk memberi tahu aplikasi bahwa kemajuan operasi pengunduhan telah diperbarui.
CHtmlView::OnPropertyChange Dipanggil untuk memberi tahu aplikasi bahwa PutProperty metode telah mengubah nilai properti.
CHtmlView::OnQuit Dipanggil untuk memberi tahu aplikasi bahwa aplikasi Internet Explorer siap untuk berhenti. (Hanya berlaku untuk Internet Explorer)
CHtmlView::OnResizeBorder Dipanggil dari implementasi Internet Explorer atau MSHTML , IOleInPlaceActiveObject::ResizeBorderyang memperingatkan objek yang diperlukan untuk mengubah ukuran ruang batasnya.
CHtmlView::OnShowContextMenu Dipanggil dari Internet Explorer atau MSHTML saat akan menampilkan menu konteksnya.
CHtmlView::OnShowUI Dipanggil sebelum Internet Explorer atau MSHTML menampilkan menu dan bilah alatnya.
CHtmlView::OnStatusBar Dipanggil StatusBar ketika properti telah berubah.
CHtmlView::OnStatusTextChange Dipanggil untuk memberi tahu aplikasi bahwa teks bilah status yang terkait dengan kontrol WebBrowser telah berubah.
CHtmlView::OnTheaterMode Dipanggil TheaterMode ketika properti telah berubah.
CHtmlView::OnTitleChange Dipanggil untuk memberi tahu aplikasi jika judul dokumen dalam kontrol WebBrowser tersedia atau berubah.
CHtmlView::OnToolBar Dipanggil ToolBar ketika properti telah berubah.
CHtmlView::OnTranslateAccelerator Dipanggil oleh Internet Explorer atau MSHTML ketika IOleInPlaceActiveObject::TranslateAccelerator atau IOleControlSite::TranslateAccelerator dipanggil untuk memproses pesan akselerator-kunci menu dari antrean pesan kontainer.
CHtmlView::OnTranslateUrl Dipanggil oleh Internet Explorer atau MSHTML untuk memungkinkan host memiliki kesempatan untuk memodifikasi URL yang akan dimuat.
CHtmlView::OnUpdateUI Memberi tahu host bahwa status perintah telah berubah.
CHtmlView::OnVisible Dipanggil ketika jendela untuk kontrol WebBrowser harus ditampilkan/disembunyikan.
CHtmlView::PutProperty Mengatur nilai properti yang terkait dengan objek yang diberikan.
CHtmlView::QueryFormsCommand Kueri untuk status satu atau beberapa perintah yang dihasilkan oleh peristiwa antarmuka pengguna.
CHtmlView::QueryStatusWB Mengkueri status perintah yang sedang diproses oleh kontrol WebBrowser.
CHtmlView::Refresh Memuat ulang file saat ini.
CHtmlView::Refresh2 Memuat ulang file saat ini dan secara opsional mencegah pragma:nocache header dikirim.
CHtmlView::SetAddressBar Memperlihatkan atau menyembunyikan bilah alamat objek Internet Explorer. (Kontrol WebBrowser mengabaikan; Internet Explorer saja.)
CHtmlView::SetFullScreen Mengatur nilai untuk menentukan apakah kontrol beroperasi dalam mode layar penuh atau dalam mode jendela normal. (Kontrol WebBrowser mengabaikan; Internet Explorer saja.)
CHtmlView::SetHeight Menyetel tinggi jendela utama Internet Explorer.
CHtmlView::SetLeft Menyetel posisi horizontal jendela utama Internet Explorer.
CHtmlView::SetMenuBar Mengatur nilai untuk menentukan apakah bilah menu kontrol terlihat. (Kontrol WebBrowser mengabaikan; Internet Explorer saja.)
CHtmlView::SetOffline Mengatur nilai untuk menentukan apakah kontrol sedang offline.
CHtmlView::SetRegisterAsBrowser Menetapkan nilai yang menunjukkan apakah kontrol WebBrowser terdaftar sebagai browser tingkat atas untuk resolusi nama target.
CHtmlView::SetRegisterAsDropTarget Menetapkan nilai yang menunjukkan apakah kontrol WebBrowser terdaftar sebagai target penurunan untuk navigasi.
CHtmlView::SetSilent Mengatur nilai untuk menentukan apakah kontrol akan menampilkan kotak dialog.
CHtmlView::SetStatusBar Mengatur nilai untuk menentukan apakah bilah status Internet Explorer terlihat. (Kontrol WebBrowser mengabaikan; Internet Explorer saja.)
CHtmlView::SetTheaterMode Mengatur nilai yang menunjukkan apakah kontrol WebBrowser berada dalam mode bioskop.
CHtmlView::SetToolBar Mengatur nilai untuk menentukan apakah toolbar kontrol terlihat. (Kontrol WebBrowser mengabaikan; Internet Explorer saja.)
CHtmlView::SetTop Menyetel posisi vertikal jendela utama Internet Explorer.
CHtmlView::SetVisible Mengatur nilai yang menunjukkan apakah objek terlihat atau tersembunyi.
CHtmlView::SetWidth Menyetel lebar jendela utama Internet Explorer.
CHtmlView::Stop Berhenti membuka file.

Keterangan

Kontrol WebBrowser adalah jendela di mana pengguna dapat menelusuri situs di World Wide Web, dan folder dalam sistem file lokal dan pada jaringan. Kontrol WebBrowser mendukung hyperlink, navigasi Uniform Resource Locator (URL), dan mempertahankan daftar riwayat.

CHtmlView Menggunakan Kelas dalam Aplikasi MFC

Dalam aplikasi kerangka kerja MFC standar (baik berbasis SDI atau MDI), objek tampilan biasanya berasal dari sekumpulan kelas khusus. Kelas-kelas ini, semuanya berasal dari CView, menyediakan fungsionalitas khusus di luar yang disediakan oleh CView.

Basing kelas tampilan aplikasi pada CHtmlView menyediakan tampilan dengan kontrol WebBrowser. Ini secara efektif menjadikan aplikasi sebagai browser web. Metode yang disukai untuk membuat aplikasi gaya browser web adalah menggunakan MFC Application Wizard, dan menentukan CHtmlView sebagai kelas tampilan. Untuk informasi selengkapnya tentang menerapkan dan menggunakan kontrol WebBrowser dalam aplikasi MFC, lihat Membuat Aplikasi Gaya Browser Web.

Catatan

Kontrol WebBrowser ActiveX (dan oleh karena itu CHtmlView) hanya tersedia untuk program yang berjalan di bawah Windows NT versi 4.0 atau yang lebih baru, di mana Internet Explorer 4.0 atau yang lebih baru telah diinstal.

CHtmlView dirancang untuk aplikasi yang mengakses dokumen Web (dan/atau HTML). Fungsi anggota berikut ini CHtmlView hanya berlaku untuk aplikasi Internet Explorer. Fungsi-fungsi ini akan berhasil pada kontrol WebBrowser, tetapi tidak akan memiliki efek yang terlihat.

Hierarki Warisan

CObject
CCmdTarget
CWnd
CView
CScrollView
CFormView

CHtmlView

Persyaratan

Header: afxhtml.h

CHtmlView::Create

Panggil fungsi anggota ini untuk membuat kontrol atau kontainer WebBrowser untuk Internet Explorer yang dapat dieksekusi.

virtual BOOL Create(
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    CCreateContext* pContext = NULL);

Parameter

lpszClassName
Menunjuk ke string karakter null-terminated yang memberi nama kelas Windows. Nama kelas dapat berupa nama apa pun yang terdaftar dengan AfxRegisterWndClass fungsi global atau RegisterClass fungsi Windows. Jika NULL, menggunakan atribut default CFrameWnd yang telah ditentukan sebelumnya.

lpszWindowName
Menunjuk ke string karakter null-terminated yang mewakili nama jendela.

dwStyle
Menentukan atribut gaya jendela. Secara default, WS_VISIBLE gaya Windows dan WS_CHILD diatur.

rect
Referensi ke struktur yang RECT menentukan ukuran dan posisi jendela. Nilai memungkinkan rectDefault Windows menentukan ukuran dan posisi jendela baru.

pParentWnd
Penunjuk ke jendela induk kontrol.

nID
Nomor ID tampilan. Secara default, set ke AFX_IDW_PANE_FIRST.

pContext
Pointer ke CCreateContext. NULL secara default.

CHtmlView::CreateControlSite

Dapat diganti digunakan untuk membuat instans situs kontrol untuk menghosting kontrol pada formulir.

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

Parameter

pContainer
Penunjuk ke objek yang COleControlContainer berisi kontrol.

ppSite
Penunjuk ke penunjuk ke COleControlSite objek, menyediakan situs untuk kontrol.

nID
Pengidentifikasi kontrol yang akan dihosting.

clsid
CLSID kontrol yang akan dihosting

Tampilkan Nilai

Mengembalikan TRUE keberhasilan, FALSE jika gagal.

Keterangan

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

CHtmlView::ExecFormsCommand

Menjalankan perintah yang ditentukan menggunakan IOleCommandTarget::Exec metode .

HRESULT ExecFormsCommand(
    DWORD dwCommandID,
    VARIANT* pVarIn,
    VARIANT* pVarOut);

Parameter

dwCommandID
Perintah yang akan dijalankan. Perintah ini harus termasuk dalam CMDSETID3_Forms3 grup.

pVarIn
Penunjuk ke struktur yang VARIANT berisi argumen input. Bisa jadi NULL.

pVarOut
Penunjuk VARIANT ke struktur untuk menerima output perintah. Bisa jadi NULL.

Tampilkan Nilai

Nilai standar HRESULT . Untuk daftar lengkap nilai yang mungkin, lihat IOleCommandTarget::Exec di Windows SDK.

Keterangan

ExecFormsCommand mengimplementasikan perilaku IOleCommandTarget::Exec metode .

CHtmlView::ExecWB

Panggil fungsi anggota ini untuk menjalankan perintah di WebBrowser atau Internet Explorer.

void ExecWB(
    OLECMDID cmdID,
    OLECMDEXECOPT cmdexecopt,
    VARIANT* pvaIn,
    VARIANT* pvaOut);

Parameter

cmdID
Perintah untuk menjalankan.

cmdexecopt
Opsi yang diatur untuk menjalankan perintah.

pvaIn
Varian yang digunakan untuk menentukan argumen input perintah.

pvaOut
Varian yang digunakan untuk menentukan argumen output perintah.

Keterangan

Lihat IWebBrowser2::ExecWB di Windows SDK.

CHtmlView::GetAddressBar

Panggil fungsi anggota ini untuk mengambil bilah alamat Internet Explorer.

BOOL GetAddressBar() const;

Tampilkan Nilai

Bukan nol jika bilah alamat terlihat; jika tidak, nol.

Keterangan

Berlaku untuk Internet Explorer. Jika Anda menggunakan panggilan ini dengan kontrol WebBrowser, itu tidak akan mengembalikan kesalahan, tetapi akan mengabaikan panggilan ini.

CHtmlView::GetApplication

Panggil fungsi anggota ini untuk mengambil objek otomatisasi yang didukung oleh aplikasi yang berisi kontrol WebBrowser.

LPDISPATCH GetApplication() const;

Tampilkan Nilai

Penunjuk ke IDispatch antarmuka objek dokumen aktif. Untuk informasi selengkapnya, lihat Menerapkan IDispatch Antarmuka.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GetBusy

Panggil fungsi anggota ini untuk menentukan apakah kontrol WebBrowser terlibat dalam operasi navigasi atau pengunduhan.

BOOL GetBusy() const;

Tampilkan Nilai

Nonzero jika browser web sibuk; jika tidak, nol.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GetContainer

Panggil fungsi anggota ini untuk mengambil objek yang mengevaluasi ke kontainer browser web.

LPDISPATCH GetContainer() const;

Tampilkan Nilai

Penunjuk ke IDispatch antarmuka objek dokumen aktif.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GetFullName

Panggil fungsi anggota ini untuk mengambil jalur lengkap file yang sedang ditampilkan Internet Explorer.

CString GetFullName() const;

Tampilkan Nilai

Objek CString yang berisi jalur dan nama file yang saat ini ditampilkan. Jika tidak ada jalur dan nama file, GetFullName mengembalikan kosong CString.

Keterangan

Berlaku untuk Internet Explorer. Jika Anda menggunakan panggilan ini dengan kontrol WebBrowser, itu tidak akan mengembalikan kesalahan, tetapi akan mengabaikan panggilan ini.

CHtmlView::GetFullScreen

Panggil fungsi anggota ini untuk menentukan apakah kontrol WebBrowser beroperasi dalam mode layar penuh atau dalam mode jendela normal.

BOOL GetFullScreen() const;

Tampilkan Nilai

Nonzero jika WebBrowser beroperasi dalam mode layar penuh; jika tidak, nol.

Keterangan

Dalam mode layar penuh, jendela utama Internet Explorer dimaksimalkan dan bilah status, toolbar, bilah menu, dan bilah judul disembunyikan.

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GetHeight

Panggil fungsi anggota ini untuk mengambil tinggi, dalam piksel, dari jendela bingkai kontrol WebBrowser.

long GetHeight() const;

Tampilkan Nilai

Tinggi jendela bingkai kontrol, dalam piksel.

CHtmlView::GetHtmlDocument

Panggil fungsi anggota ini untuk mengambil dokumen HTML untuk dokumen aktif.

LPDISPATCH GetHtmlDocument() const;

Tampilkan Nilai

Penunjuk ke IDispatch antarmuka objek dokumen aktif.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GetLeft

Panggil fungsi anggota ini untuk mengambil jarak antara tepi kiri internal kontrol WebBrowser dan tepi kiri kontainernya.

long GetLeft() const;

Tampilkan Nilai

Jarak tepi kiri, dalam piksel.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GetLocationName

Panggil fungsi anggota ini untuk mendapatkan nama sumber daya yang ditampilkan di WebBrowser.

CString GetLocationName() const;

Tampilkan Nilai

Objek CString yang berisi nama sumber daya yang saat ini ditampilkan di WebBrowser.

Keterangan

Jika sumber daya adalah halaman HTML di World Wide Web, nama tersebut adalah judul halaman tersebut. Jika sumber daya adalah folder atau file di jaringan atau komputer lokal, nama tersebut adalah UNC atau jalur lengkap folder atau file.

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GetLocationURL

Panggil fungsi anggota ini untuk mengambil URL sumber daya yang saat ini ditampilkan kontrol WebBrowser.

CString GetLocationURL() const;

Tampilkan Nilai

Objek CString yang berisi URL sumber daya yang saat ini ditampilkan di WebBrowser.

Keterangan

Jika sumber daya adalah folder atau file di jaringan atau komputer lokal, nama tersebut adalah UNC atau jalur lengkap folder atau file.

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GetMenuBar

Panggil fungsi anggota ini untuk menentukan apakah bilah menu terlihat.

BOOL GetMenuBar() const;

Tampilkan Nilai

Bukan nol jika bilah menu terlihat; jika tidak, nol.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GetOffline

Panggil fungsi anggota ini untuk menentukan apakah browser web beroperasi secara offline.

BOOL GetOffline() const;

Tampilkan Nilai

Bukan nol jika browser web saat ini offline; jika tidak, nol.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GetParentBrowser

Panggil fungsi anggota ini untuk mengambil penunjuk ke objek induk kontrol WebBrowser.

LPDISPATCH GetParentBrowser() const;

Tampilkan Nilai

Penunjuk ke IDispatch antarmuka objek yang merupakan induk kontrol WebBrowser.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GetProperty

Panggil fungsi anggota ini untuk mendapatkan nilai properti yang saat ini terkait dengan kontrol.

BOOL GetProperty(
    LPCTSTR lpszProperty,
    CString& strValue);

COleVariant GetProperty(LPCTSTR lpszProperty);

Parameter

lpszProperty
Penunjuk ke string yang berisi properti untuk diambil.

strValue
Referensi ke CString objek yang menerima nilai properti saat ini.

Tampilkan Nilai

Di versi pertama, nonzero jika berhasil diselesaikan; jika tidak, nol. Di versi kedua, objek COleVariant .

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GetReadyState

Panggil fungsi anggota ini untuk mengambil status siap objek WebBrowser.

READYSTATE GetReadyState() const;

Tampilkan Nilai

Nilai READYSTATE , seperti yang dijelaskan dalam Windows SDK.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GetRegisterAsBrowser

Panggil fungsi anggota ini untuk menentukan apakah objek WebBrowser terdaftar sebagai browser tingkat atas untuk resolusi nama target.

BOOL GetRegisterAsBrowser() const;

Tampilkan Nilai

Nonzero jika browser terdaftar sebagai browser tingkat atas; jika tidak, nol.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GetRegisterAsDropTarget

Panggil fungsi anggota ini untuk menentukan apakah kontrol WebBrowser terdaftar sebagai target penurunan untuk navigasi.

BOOL GetRegisterAsDropTarget() const;

Tampilkan Nilai

Nonzero jika browser terdaftar sebagai target drop; jika tidak, nol.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GetSilent

Panggil fungsi anggota ini untuk menentukan apakah ada kotak dialog yang dapat ditampilkan di kontrol WebBrowser.

BOOL GetSilent() const;

Tampilkan Nilai

Bukan nol jika kotak dialog tidak dapat ditampilkan dari kontrol WebBrowser; jika tidak, nol.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GetSource

Panggil fungsi anggota ini untuk mengambil kode sumber HTML untuk halaman web.

BOOL GetSource(CString& strRef);

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Parameter

refString
Yang CString akan menyimpan kode sumber.

Keterangan

Fungsi ini setara dengan perintah "Lihat Sumber" di Internet Explorer, kecuali bahwa kode sumber dikembalikan dalam CString.

CHtmlView::GetStatusBar

Panggil fungsi anggota ini untuk menentukan apakah kontrol WebBrowser menampilkan bilah status.

BOOL GetStatusBar() const;

Tampilkan Nilai

Bukan nol jika bilah status dapat ditampilkan; jika tidak, nol.

Keterangan

Berlaku untuk Internet Explorer. Jika Anda menggunakan panggilan ini dengan kontrol WebBrowser, itu tidak akan mengembalikan kesalahan, tetapi akan mengabaikan panggilan ini.

CHtmlView::GetTheaterMode

Panggil fungsi anggota ini untuk menentukan apakah browser web berada dalam mode bioskop.

BOOL GetTheaterMode() const;

Tampilkan Nilai

Nonzero jika browser web berada dalam mode bioskop; jika tidak, nol.

Keterangan

Saat browser web dalam mode teater, jendela utama browser mengisi seluruh layar, toolbar dengan sekumpulan alat navigasi minimal muncul, dan bilah status muncul di sudut kanan atas layar.

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GetToolBar

Panggil fungsi anggota ini untuk menentukan apakah toolbar terlihat.

int GetToolBar() const;

Tampilkan Nilai

Nilai yang menunjukkan apakah toolbar terlihat. Bukan nol jika toolbar terlihat; jika tidak, nol.

CHtmlView::GetTop

Panggil fungsi anggota ini untuk mengambil koordinat layar tepi atas jendela utama kontrol WebBrowser.

long GetTop() const;

Tampilkan Nilai

Alamat variabel yang menerima koordinat layar tepi atas jendela utama.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GetTopLevelContainer

Panggil fungsi anggota ini untuk menentukan apakah Internet Explorer adalah kontainer tingkat atas kontrol WebBrowser.

BOOL GetTopLevelContainer() const;

Tampilkan Nilai

Nonzero kontainer adalah kontainer tingkat atas; jika tidak, nol.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GetType

Panggil fungsi anggota ini untuk mengambil nama jenis dokumen aktif yang terkandung.

CString GetType() const;

Tampilkan Nilai

Objek CString yang berisi nama jenis dokumen aktif yang terkandung.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GetVisible

Panggil fungsi anggota ini untuk menentukan apakah objek yang terkandung terlihat.

BOOL GetVisible() const;

Tampilkan Nilai

Bukan nol jika objek terlihat; jika tidak, nol.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GetWidth

Mengambil lebar jendela utama Internet Explorer.

long GetWidth() const;

Tampilkan Nilai

Lebar jendela saat ini, dalam piksel.

CHtmlView::GoBack

Menavigasi mundur satu item dalam daftar riwayat.

void GoBack();

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GoForward

Menavigasi meneruskan satu item dalam daftar riwayat.

void GoForward();

CHtmlView::GoHome

Navigasi ke beranda atau halaman awal saat ini yang ditentukan dalam kotak dialog Opsi Internet Explorer atau kotak dialog Properti Internet, diakses dari Panel Kontrol.

void GoHome();

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::GoSearch

Navigasi ke halaman pencarian saat ini, seperti yang ditentukan dalam kotak dialog Opsi Internet Explorer atau kotak dialog Properti Internet, diakses dari Panel Kontrol.

void GoSearch();

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::LoadFromResource

Panggil fungsi anggota ini untuk memuat sumber daya yang ditentukan ke dalam kontrol WebBrowser.

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

Parameter

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

nRes
ID buffer yang berisi nama sumber daya yang akan dimuat.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

Panggil fungsi anggota ini untuk menavigasi ke sumber daya yang diidentifikasi oleh URL.

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

Parameter

URL
String yang dialokasikan penelepon yang berisi URL untuk dinavigasi, atau jalur lengkap file yang akan ditampilkan.

dwFlags
Bendera variabel yang menentukan apakah akan menambahkan sumber daya ke daftar riwayat, apakah akan membaca 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 hal-hal 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.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

Panggil fungsi anggota ini untuk menavigasi ke sumber daya yang diidentifikasi oleh URL, atau ke file yang diidentifikasi oleh jalur lengkap.

void Navigate2(
    LPITEMIDLIST pIDL,
    DWORD dwFlags = 0,
    LPCTSTR lpszTargetFrameName = NULL);

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

void Navigate2(
    LPCTSTR lpszURL,
    DWORD dwFlags,
    CByteArray& baPostedData,
    LPCTSTR lpszTargetFrameName = NULL,
    LPCTSTR lpszHeader = NULL);

Parameter

pIDL
Penunjuk ke ITEMIDLIST struktur.

dwFlags
Bendera variabel yang menentukan apakah akan menambahkan sumber daya ke daftar riwayat, apakah akan membaca 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.

lpszURL
Penunjuk ke string yang berisi URL.

lpvPostData
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, Navigate2 keluarkan transaksi HTTP GET. Parameter ini diabaikan jika URL bukan URL HTTP atau HTTPS.

dwPostDataLen
Panjang dalam byte data yang ditujukkan oleh lpvPostData parameter .

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

baPostedData
Referensi ke CByteArray objek.

Keterangan

Fungsi anggota ini memperluas Navigate fungsi anggota dengan mendukung penjelajahan pada folder khusus, seperti Desktop dan Komputer Saya, yang diwakili oleh parameter pIDL.

Berlaku untuk Internet Explorer dan WebBrowser.

Contoh

void CMyHtmlView::OnGoToMicrosoft()
{
   Navigate2(_T("http://home.microsoft.com"));
}

CHtmlView::OnBeforeNavigate2

Fungsi anggota ini dipanggil oleh kerangka kerja untuk menyebabkan peristiwa diaktifkan sebelum operasi navigasi terjadi di browser web.

virtual void OnBeforeNavigate2(
    LPCTSTR lpszURL,
    DWORD nFlags,
    LPCTSTR lpszTargetFrameName,
    CByteArray& baPostedData,
    LPCTSTR lpszHeaders,
    BOOL* pbCancel);

Parameter

lpszURL
Penunjuk ke string yang berisi URL untuk dinavigasi.

nFlags
Disiapkan untuk penggunaan masa mendatang.

lpszTargetFrameName
String yang berisi nama bingkai untuk menampilkan sumber daya, atau NULL jika tidak ada bingkai bernama yang ditargetkan untuk sumber daya.

baPostedData
Referensi ke objek yang CByteArray berisi data untuk dikirim ke server jika transaksi HTTP POST sedang digunakan.

lpszHeaders
Penunjuk ke string yang berisi header HTTP lain untuk dikirim ke server (HANYA URL HTTP). Header dapat menentukan hal-hal seperti tindakan yang diperlukan server, jenis data yang diteruskan ke server, atau kode status.

pbCancel
Penunjuk ke bendera pembatalan. Aplikasi dapat mengatur parameter ini ke nonzero untuk membatalkan operasi navigasi, atau ke nol untuk memungkinkannya melanjutkan.

CHtmlView::OnCommandStateChange

Fungsi anggota ini dipanggil oleh kerangka kerja untuk memberi tahu aplikasi bahwa status aktif perintah browser web telah berubah.

virtual void OnCommandStateChange(
    long nCommand,
    BOOL bEnable);

Parameter

nCommand
Pengidentifikasi perintah yang statusnya diaktifkan telah berubah.

bEnable
Status diaktifkan. Parameter ini bukan nol jika perintah diaktifkan, atau nol jika dinonaktifkan.

CHtmlView::OnDocumentComplete

Fungsi anggota ini dipanggil oleh kerangka kerja untuk memberi tahu aplikasi bahwa dokumen telah mencapai status READYSTATE_COMPLETE .

virtual void OnDocumentComplete(LPCTSTR lpszURL);

Parameter

lpszURL
Penunjuk ke string yang mengevaluasi ke URL, nama file UNC, atau PIDL (penunjuk ke daftar pengidentifikasi item) yang dinavigasi.

Keterangan

Tidak setiap bingkai akan menembakkan peristiwa ini, tetapi setiap bingkai yang menembakkan OnDownloadBegin peristiwa akan menembakkan OnDocumentComplete peristiwa yang sesuai.

URL yang ditunjukkan oleh lpszURL dapat berbeda dari URL tempat browser diberitahu untuk menavigasi, karena URL ini adalah URL kanonis dan memenuhi syarat. Misalnya, jika aplikasi menentukan URL "www.microsoft.com" dalam panggilan ke Navigate atau Navigate2, URL yang diteruskan oleh OnNavigateComplete2 akan menjadi "<https://www.microsoft.com/>". Selain itu, jika server telah mengalihkan browser ke URL yang berbeda, URL yang dialihkan akan tercermin di sini.

CHtmlView::OnDocWindowActivate

Dipanggil dari implementasi Internet Explorer atau MSHTML dari IOleInPlaceActiveObject::OnDocWindowActivate, yang memberi tahu objek aktif di tempat ketika jendela dokumen kontainer diaktifkan atau dinonaktifkan.

virtual HRESULT OnDocWindowActivate(BOOL fActivate);

Parameter

fActivate
Menunjukkan status jendela dokumen. Jika nilai ini bukan nol, jendela sedang diaktifkan. Jika nilai ini nol, jendela sedang dinonaktifkan.

Tampilkan Nilai

S_OK jika berhasil, atau kode kesalahan yang ditentukan OLE sebaliknya.

Keterangan

Ambil alih OnDocWindowActivate untuk bereaksi terhadap OnDocWindowActivate pemberitahuan dari kontrol Microsoft Web Browser. Lihat IDocHostUIHandler::OnDocWindowActivate di Windows SDK untuk informasi selengkapnya.

CHtmlView::OnDownloadBegin

Fungsi anggota ini dipanggil oleh kerangka kerja untuk mulai mengunduh dokumen.

virtual void OnDownloadBegin();

Keterangan

Kejadian ini diaktifkan tak lama setelah OnBeforeNavigate2 acara, kecuali navigasi dibatalkan. Setiap animasi atau indikasi "sibuk" yang perlu ditampilkan kontainer harus terhubung ke peristiwa ini.

CHtmlView::OnDownloadComplete

Fungsi anggota ini dipanggil oleh kerangka kerja untuk menunjukkan bahwa operasi navigasi selesai, dihentikan, atau gagal.

virtual void OnDownloadComplete();

CHtmlView::OnEnableModeless

Dipanggil ketika Internet Explorer atau MSHTML menampilkan UI modal.

virtual HRESULT OnEnableModeless(BOOL fEnable);

Parameter

fEnable
Menunjukkan apakah kotak dialog tanpa mode host diaktifkan atau dinonaktifkan. Jika nilai ini bukan nol, kotak dialog tanpa mode diaktifkan. Jika nilai ini nol, kotak dialog tanpa mode akan dinonaktifkan.

Tampilkan Nilai

S_OK jika berhasil, atau kode kesalahan yang ditentukan OLE sebaliknya.

Keterangan

Mengaktifkan atau menonaktifkan kotak dialog tanpa mode saat kontainer membuat atau menghancurkan kotak dialog modal. Ambil alih OnEnableModeless untuk bereaksi terhadap EnableModeless pemberitahuan dari kontrol Microsoft Web Browser. Lihat IDocHostUIHandler::EnableModeless di Windows SDK untuk informasi selengkapnya.

CHtmlView::OnFilterDataObject

Dipanggil pada host oleh Internet Explorer atau MSHTML untuk memungkinkan host menggantikan objek data Internet Explorer atau MSHTML.

virtual HRESULT OnFilterDataObject(
    LPDATAOBJECT pDataObject,
    LPDATAOBJECT* ppDataObject);

Parameter

pDataObject
Alamat antarmuka yang IDataObject disediakan oleh Internet Explorer atau MSHTML.

ppDataObject
Alamat yang menerima pointer IDataObject antarmuka yang disediakan oleh host. Konten parameter ini harus selalu diinisialisasi ke NULL, bahkan jika metode gagal.

Tampilkan Nilai

S_OK jika objek data diganti, S_FALSE jika objek data tidak diganti, atau kode kesalahan yang ditentukan OLE jika terjadi kesalahan.

Keterangan

Ambil alih OnFilterDataObject untuk bereaksi terhadap FilterDataObject pemberitahuan dari kontrol Microsoft Web Browser. Lihat IDocHostUIHandler::FilterDataObject di Windows SDK untuk informasi selengkapnya.

CHtmlView::OnFrameWindowActivate

Dipanggil dari IOleInPlaceActiveObject::OnFrameWindowActivate untuk memberi tahu objek ketika jendela bingkai tingkat atas kontainer diaktifkan atau dinonaktifkan.

virtual HRESULT OnFrameWindowActivate(BOOL fActivate);

Parameter

fActivate
Menunjukkan status jendela bingkai tingkat atas kontainer. Jika nilai ini bukan nol, jendela sedang diaktifkan. Jika nilai ini nol, jendela sedang dinonaktifkan.

Tampilkan Nilai

S_OK jika berhasil, atau kode kesalahan yang ditentukan OLE sebaliknya.

Keterangan

Ambil alih OnFrameWindowActivate untuk bereaksi terhadap OnFrameWindowActivate pemberitahuan dari kontrol Microsoft Web Browser. Lihat IDocHostUIHandler::OnFrameWindowActivate di Windows SDK untuk informasi selengkapnya.

CHtmlView::OnFullScreen

Fungsi anggota ini dipanggil oleh kerangka kerja ketika FullScreen properti telah berubah.

virtual void OnFullScreen(BOOL bFullScreen);

Parameter

bFullScreen
Bukan nol jika Internet Explorer dalam mode layar penuh; nol jika tidak.

CHtmlView::OnGetDropTarget

Dipanggil oleh Internet Explorer atau MSHTML ketika digunakan sebagai target penurunan untuk memungkinkan host menyediakan alternatif IDropTarget.

virtual HRESULT OnGetDropTarget(
    LPDROPTARGET pDropTarget,
    LPDROPTARGET* ppDropTarget);

Parameter

pDropTarget
IDropTarget Internet Explorer atau MSHTML mengusulkan untuk digunakan.

ppDropTarget
Alamat yang IDropTarget menerima pointer IDropTarget antarmuka yang ingin disediakan host.

Tampilkan Nilai

Lihat IDocHostUIHandler::GetDropTarget di Windows SDK untuk daftar kode pengembalian.

Keterangan

Ambil alih OnGetDropTarget untuk bereaksi terhadap GetDropTarget pemberitahuan dari kontrol Microsoft Web Browser. Lihat IDocHostUIHandler::GetDropTarget di Windows SDK untuk informasi selengkapnya.

CHtmlView::OnGetExternal

Dipanggil oleh Internet Explorer atau MSHTML untuk mendapatkan antarmuka host IDispatch .

virtual HRESULT OnGetExternal(LPDISPATCH* lppDispatch);

Parameter

lppDispatch
Penunjuk ke alamat yang menerima IDispatch penunjuk antarmuka aplikasi host. Jika host mengekspos antarmuka Automation, host dapat memberikan referensi ke Internet Explorer atau MSHTML melalui parameter ini. Konten parameter ini harus selalu diinisialisasi ke NULL, bahkan jika metode gagal.

Tampilkan Nilai

S_OK jika berhasil, atau kode kesalahan yang ditentukan OLE sebaliknya.

Keterangan

Ambil alih OnGetExternal untuk bereaksi terhadap GetExternal pemberitahuan dari kontrol Microsoft Web Browser. Lihat IDocHostUIHandler::GetExternal di Windows SDK untuk informasi selengkapnya.

CHtmlView::OnGetHostInfo

Mengambil kemampuan UI host Internet Explorer atau MSHTML.

virtual HRESULT OnGetHostInfo(DOCHOSTUIINFO* pInfo);

Parameter

pInfo
DOCHOSTUIINFO Alamat struktur yang menerima kemampuan UI host.

Tampilkan Nilai

S_OK jika berhasil, atau kode kesalahan yang ditentukan OLE sebaliknya.

Keterangan

Ambil alih OnGetHostInfo untuk bereaksi terhadap GetHostInfo pemberitahuan dari kontrol Microsoft Web Browser. Lihat IDocHostUIHandler::GetHostInfo di Windows SDK untuk informasi selengkapnya.

CHtmlView::OnGetOptionKeyPath

Panggil fungsi anggota ini untuk mendapatkan kunci registri di mana Internet Explorer atau MSHTML menyimpan preferensi pengguna.

virtual HRESULT OnGetOptionKeyPath(
    LPOLESTR* pchKey,
    DWORD dwReserved);

Parameter

pchKey
Alamat yang LPOLESTR menerima string subkuntang registri tempat host menyimpan opsi defaultnya. Subkunjuk ini akan berada di bawah HKEY_CURRENT_USER kunci. Alokasikan memori ini menggunakan CoTaskMemAlloc. Aplikasi panggilan bertanggung jawab untuk membebaskan memori ini menggunakan CoTaskMemFree. Parameter ini harus selalu diinisialisasi ke NULL, bahkan jika metode gagal.

dwReserved
Disiapkan untuk penggunaan masa mendatang. Saat ini tidak digunakan.

Tampilkan Nilai

S_OK jika berhasil, atau S_FALSE sebaliknya. Jika S_FALSE, Internet Explorer atau MSHTML akan default ke opsi penggunanya sendiri.

Keterangan

Ambil alih OnGetOptionKeyPath untuk bereaksi terhadap GetOptionKeyPath pemberitahuan dari kontrol Microsoft Web Browser. Lihat IDocHostUIHandler::GetOptionKeyPath di Windows SDK untuk informasi selengkapnya.

CHtmlView::OnHideUI

Fungsi anggota ini dipanggil oleh kerangka kerja ketika Internet Explorer atau MSHTML menghapus menu dan bilah alatnya.

virtual HRESULT OnHideUI();

Tampilkan Nilai

S_OK jika berhasil, atau kode kesalahan yang ditentukan OLE sebaliknya.

Keterangan

Ambil alih OnHideUI untuk bereaksi terhadap HideUI pemberitahuan dari kontrol Microsoft Web Browser. Lihat IDocHostUIHandler::HideUI di Windows SDK untuk informasi selengkapnya.

CHtmlView::OnMenuBar

Fungsi anggota ini dipanggil oleh kerangka kerja ketika MenuBar properti telah berubah.

virtual void OnMenuBar(BOOL bMenuBar);

Parameter

bMenuBar
Bukan nol jika bilah menu Internet Explorer terlihat; nol jika tidak.

CHtmlView::OnNavigateComplete2

Fungsi anggota ini dipanggil oleh kerangka kerja setelah navigasi ke hyperlink selesai (pada elemen jendela atau frameset).

virtual void OnNavigateComplete2(LPCTSTR strURL);

Parameter

strURL
Ekspresi string yang mengevaluasi ke URL, nama file UNC, atau PIDL (penunjuk ke daftar pengidentifikasi item) yang dinavigasi.

Keterangan

Parameter URL dapat menjadi PIDL jika ada entitas ruang nama shell yang tidak ada representasi URL.

URL yang terkandung strURL dapat berbeda dari URL tempat browser diberitahu untuk menavigasi, karena URL ini adalah URL kanonis dan memenuhi syarat. Misalnya, jika aplikasi menentukan URL "www.microsoft.com" dalam panggilan ke Navigate atau Navigate2, URL yang diteruskan oleh OnNavigateComplete2 akan menjadi "<https://www.microsoft.com/>". Selain itu, jika server telah mengalihkan browser ke URL yang berbeda, URL yang dialihkan akan tercermin di sini.

CHtmlView::OnNavigateError

Dipanggil oleh kerangka kerja jika navigasi ke hyperlink gagal.

virtual void OnNavigateError(
    LPCTSTR lpszURL,
    LPCTSTR lpszFrame,
    DWORD dwError,
    BOOL* pbCancel);

Parameter

lpszURL
URL yang navigasinya gagal.

lpszFrame
Nama bingkai tempat sumber daya akan ditampilkan, atau NULL jika tidak ada bingkai bernama yang ditargetkan untuk sumber daya.

dwError
Kode status kesalahan, jika tersedia. Untuk daftar kode status HTTP dan yang mungkin HRESULT , lihat NavigateError Kode Status Peristiwa..

pbCancel
Menentukan apakah akan membatalkan navigasi ke halaman kesalahan atau arsip otomatis lebih lanjut. Jika TRUE (default), lanjutkan dengan navigasi ke halaman kesalahan atau arsip otomatis; jika FALSE, batalkan navigasi ke halaman kesalahan atau arsip otomatis.

Keterangan

Ambil alih metode ini untuk menyediakan penanganan kesalahan navigasi kustom.

Untuk informasi selengkapnya, lihat DWebBrowserEvents2::NavigateError

CHtmlView::OnNewWindow2

Fungsi anggota ini dipanggil oleh kerangka kerja ketika jendela baru akan dibuat untuk menampilkan sumber daya.

virtual void OnNewWindow2(
    LPDISPATCH* ppDisp,
    BOOL* Cancel);

Parameter

ppDisp
Penunjuk ke penunjuk antarmuka yang, secara opsional, menerima IDispatch penunjuk antarmuka objek WebBrowser atau Internet Explorer baru.

Cancel
Penunjuk ke bendera pembatalan. Aplikasi dapat mengatur parameter ini ke nonzero untuk membatalkan operasi navigasi, atau ke nol untuk memungkinkannya melanjutkan.

Keterangan

Kejadian ini mendahului pembuatan jendela baru dari dalam WebBrowser.

CHtmlView::OnProgressChange

Fungsi anggota ini dipanggil oleh kerangka kerja untuk memberi tahu aplikasi bahwa kemajuan operasi pengunduhan telah diperbarui.

virtual void OnProgressChange(
    long nProgress,
    long nProgressMax);

Parameter

nProgress
Jumlah total kemajuan yang akan ditampilkan, atau -1 saat kemajuan selesai.

nProgressMax
Nilai kemajuan maksimum.

Keterangan

Kontainer dapat menggunakan informasi yang disediakan oleh peristiwa ini untuk menampilkan jumlah byte yang diunduh sejauh ini atau untuk memperbarui indikator kemajuan.

CHtmlView::OnPropertyChange

Fungsi anggota ini dipanggil oleh kerangka kerja untuk memberi tahu aplikasi yang PutProperty telah mengubah nilai properti.

virtual void OnPropertyChange(LPCTSTR lpszProperty);

Parameter

lpszProperty
Penunjuk ke string yang berisi nama properti .

CHtmlView::OnQuit

Fungsi anggota ini dipanggil oleh kerangka kerja untuk memberi tahu aplikasi bahwa aplikasi Internet Explorer siap untuk berhenti.

virtual void OnQuit();

CHtmlView::OnResizeBorder

Dipanggil dari implementasi Internet Explorer atau MSHTML , IOleInPlaceActiveObject::ResizeBorderyang memperingatkan objek yang diperlukan untuk mengubah ukuran ruang batasnya.

virtual HRESULT OnResizeBorder(
    LPCRECT prcBorder,
    LPOLEINPLACEUIWINDOW pUIWindow,
    BOOL fFrameWindow);

Parameter

prcBorder
Persegi panjang luar baru untuk ruang batas.

pUIWindow
Penunjuk ke antarmuka untuk bingkai atau objek jendela dokumen yang batasnya telah berubah.

fFrameWindow
TRUE jika jendela bingkai memanggil IOleInPlaceActiveObject::ResizeBorder, jika tidak FALSE.

Tampilkan Nilai

S_OK jika berhasil, atau kode kesalahan yang ditentukan OLE sebaliknya.

Keterangan

Ambil alih OnResizeBorder untuk bereaksi terhadap ResizeBorder pemberitahuan dari kontrol Microsoft Web Browser. Lihat IDocHostUIHandler::ResizeBorder di Windows SDK untuk informasi selengkapnya.

CHtmlView::OnShowContextMenu

Dipanggil dari Internet Explorer atau MSHTML saat akan menampilkan menu konteksnya.

virtual HRESULT OnShowContextMenu(
    DWORD dwID,
    LPPOINT ppt,
    LPUNKNOWN pcmdtReserved,
    LPDISPATCH pdispReserved);

Parameter

dwID
Pengidentifikasi menu konteks yang akan ditampilkan. Lihat IDocHostUIHandler::ShowContextMenu di Windows SDK untuk daftar nilai.

ppt
Koordinat layar untuk menu.

pcmdtReserved
IOleCommandTarget antarmuka yang digunakan untuk mengkueri status perintah dan menjalankan perintah pada objek ini.

pdispReserved
IDispatch antarmuka objek di koordinat layar. Ini memungkinkan host untuk membedakan objek tertentu untuk memberikan konteks yang lebih spesifik.

Tampilkan Nilai

Lihat IDocHostUIHandler::ShowContextMenu di Windows SDK untuk daftar nilai.

Keterangan

Ambil alih OnShowContextMenu untuk bereaksi terhadap ShowContextMenu pemberitahuan dari kontrol Microsoft Web Browser. Lihat IDocHostUIHandler::ShowContextMenu di Windows SDK untuk informasi selengkapnya.

CHtmlView::OnShowUI

Dipanggil sebelum Internet Explorer atau MSHTML menampilkan menu dan bilah alatnya.

virtual HRESULT OnShowUI(
    DWORD dwID,
    LPOLEINPLACEACTIVEOBJECT pActiveObject,
    LPOLECOMMANDTARGET pCommandTarget,
    LPOLEINPLACEFRAME pFrame,
    LPOLEINPLACEUIWINDOW pDoc);

Parameter

dwID
Disiapkan untuk penggunaan masa mendatang.

pActiveObject
IOleInPlaceActiveObject antarmuka objek yang saat ini aktif.

pCommandTarget
IOleCommandTarget antarmuka objek.

pFrame
IOleInPlaceFrame antarmuka objek. Ini diperlukan untuk menu dan bilah alat.

pDoc
IOleInPlaceUIWindow antarmuka untuk objek. Ini diperlukan untuk bilah alat.

Tampilkan Nilai

Lihat IDocHostUIHandler::ShowUI di Windows SDK untuk daftar nilai.

Keterangan

Ambil alih OnShowUI untuk bereaksi terhadap ShowUI pemberitahuan dari kontrol Microsoft Web Browser. Lihat IDocHostUIHandler::ShowUI di Windows SDK untuk informasi selengkapnya.

CHtmlView::OnStatusBar

Fungsi anggota ini dipanggil oleh kerangka kerja ketika StatusBar properti telah berubah.

virtual void OnStatusBar(BOOL bStatusBar);

Parameter

bStatusBar
Bukan nol jika bilah status Internet Explorer terlihat atau nol sebaliknya.

CHtmlView::OnStatusTextChange

Fungsi anggota ini dipanggil oleh kerangka kerja untuk memberi tahu aplikasi bahwa teks bilah status yang terkait dengan kontrol WebBrowser telah berubah.

virtual void OnStatusTextChange(LPCTSTR lpszText);

Parameter

lpszText
String yang berisi teks bilah status baru.

CHtmlView::OnTheaterMode

Fungsi anggota ini dipanggil oleh kerangka kerja ketika TheaterMode properti telah berubah.

virtual void OnTheaterMode(BOOL bTheaterMode);

Parameter

bTheaterMode
Bukan nol jika Internet Explorer berada dalam mode bioskop; nol jika tidak.

CHtmlView::OnTitleChange

Fungsi anggota ini dipanggil oleh kerangka kerja untuk memberi tahu aplikasi jika judul dokumen dalam kontrol WebBrowser tersedia atau berubah.

virtual void OnTitleChange(LPCTSTR lpszText);

Parameter

lpszText
Judul dokumen baru.

Keterangan

Untuk HTML, judul mungkin berubah; saat HTML masih diunduh, URL dokumen ditetapkan sebagai judul. Setelah judul nyata (jika ada) diurai dari HTML, judul diubah untuk mencerminkan judul aktual.

CHtmlView::OnToolBar

Fungsi anggota ini dipanggil oleh kerangka kerja ketika ToolBar properti telah berubah.

virtual void OnToolBar(BOOL bToolBar);

Parameter

bToolBar
Bukan nol jika bilah alat Internet Explorer terlihat atau nol sebaliknya.

CHtmlView::OnTranslateAccelerator

Dipanggil oleh Internet Explorer atau MSHTML ketika IOleInPlaceActiveObject::TranslateAccelerator atau IOleControlSite::TranslateAccelerator dipanggil untuk memproses pesan akselerator-kunci menu dari antrean pesan kontainer.

virtual HRESULT OnTranslateAccelerator(
    LPMSG lpMsg,
    const GUID* pguidCmdGroup,
    DWORD nCmdID);

Parameter

lpMsg
Menunjuk ke pesan yang mungkin perlu diterjemahkan.

pguidCmdGroup
Pengidentifikasi grup perintah.

nCmdID
Pengidentifikasi perintah.

Tampilkan Nilai

S_OK jika berhasil, atau S_FALSE sebaliknya.

Keterangan

Ambil alih OnTranslateAccelerator untuk bereaksi terhadap TranslateAccelerator pemberitahuan dari kontrol Microsoft Web Browser. Lihat IDocHostUIHandler::TranslateAccelerator di Windows SDK untuk informasi selengkapnya.

CHtmlView::OnTranslateUrl

Dipanggil oleh Internet Explorer atau MSHTML untuk memungkinkan host memiliki kesempatan untuk memodifikasi URL yang akan dimuat.

virtual HRESULT OnTranslateUrl(
    DWORD dwTranslate,
    OLECHAR* pchURLIn,
    OLECHAR** ppchURLOut);

Parameter

dwTranslate
Disiapkan untuk penggunaan masa mendatang.

pchURLIn
Alamat string yang disediakan oleh Internet Explorer atau MSHTML yang mewakili URL yang akan diterjemahkan.

ppchURLOut
Alamat penunjuk string yang menerima alamat URL yang diterjemahkan. Host mengalokasikan buffer menggunakan alokator memori tugas. Konten parameter ini harus selalu diinisialisasi ke NULL, bahkan jika URL tidak diterjemahkan atau metode gagal.

Tampilkan Nilai

S_OK jika URL diterjemahkan, S_FALSE jika URL tidak diterjemahkan, atau kode kesalahan yang ditentukan OLE jika terjadi kesalahan.

Keterangan

Ambil alih OnTranslateUrl untuk bereaksi terhadap TranslateUrl pemberitahuan dari kontrol Microsoft Web Browser. Lihat IDocHostUIHandler::TranslateUrl di Windows SDK untuk informasi selengkapnya.

CHtmlView::OnUpdateUI

Memberi tahu host bahwa status perintah telah berubah.

virtual HRESULT OnUpdateUI();

Tampilkan Nilai

S_OK jika berhasil, atau kode kesalahan yang ditentukan OLE sebaliknya.

Keterangan

Host harus memperbarui status tombol toolbar. Metode ini dipanggil terlepas dari nilai pengembalian dari ShowUI. Ambil alih OnUpdateUI untuk bereaksi terhadap UpdateUI pemberitahuan dari kontrol Microsoft Web Browser.

CHtmlView::OnVisible

Fungsi anggota ini dipanggil oleh kerangka kerja ketika jendela untuk WebBrowser harus ditampilkan atau disembunyikan.

virtual void OnVisible(BOOL bVisible);

Parameter

bVisible
Bukan nol jika objek terlihat atau nol sebaliknya.

Keterangan

Ini memungkinkan jendela host kontrol objek berulah dengan cara yang sama seperti jendela Internet Explorer akan berulah.

CHtmlView::PutProperty

Panggil fungsi anggota ini untuk mengatur properti yang terkait dengan objek tertentu.

void PutProperty(
    LPCTSTR lpszProperty,
    const VARIANT& vtValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    double dValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    long lValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    LPCTSTR lpszValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    short nValue);

Parameter

lpszProperty
String yang berisi properti yang akan diatur.

vtValue
Nilai baru properti yang ditunjukkan oleh lpszProperty.

lpszPropertyName
Penunjuk ke string yang berisi nama properti yang akan diatur.

dValue
Nilai baru properti.

lValue
Nilai baru properti.

lpszValue
Penunjuk ke string yang berisi nilai baru properti.

nValue
Nilai baru properti.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::QueryFormsCommand

Kueri untuk status satu atau beberapa perintah yang dihasilkan oleh peristiwa antarmuka pengguna.

HRESULT QueryFormsCommand(
    DWORD dwCommandID,
    BOOL* pbSupported,
    BOOL* pbEnabled,
    BOOL* pbChecked);

Parameter

dwCommandID
Pengidentifikasi perintah yang sedang dikueri.

pbSupported
Penunjuk ke BOOL menentukan apakah perintah (diidentifikasi oleh dwCommandID) didukung. Jika TRUE, perintah didukung; jika tidak FALSE.

pbEnabled
Penunjuk ke BOOL menentukan apakah perintah (diidentifikasi oleh dwCommandID) diaktifkan. Jika TRUE, perintah didukung; jika tidak FALSE.

pbChecked
Penunjuk ke BOOL menentukan apakah perintah (diidentifikasi oleh dwCommandID) dicentang. Jika TRUE, perintah didukung; jika tidak FALSE.

Tampilkan Nilai

Nilai standar HRESULT . Untuk daftar lengkap nilai yang mungkin, lihat IOleCommandTarget::QueryStatus di Windows SDK.

Keterangan

QueryFormsCommand mengimplementasikan perilaku IOleCommandTarget::QueryStatus metode .

CHtmlView::QueryStatusWB

Panggil fungsi anggota ini untuk mengkueri status perintah.

OLECMDF QueryStatusWB(OLECMDID cmdID) const;

Parameter

cmdID
Nilai OLECMDID perintah tempat pemanggil membutuhkan informasi status.

Tampilkan Nilai

Alamat OLECMDF nilai yang menerima status perintah.

Keterangan

QueryStatusWB mengimplementasikan perilaku IOleCommandTarget::QueryStatus metode .

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::Refresh

Memuat ulang URL atau file yang saat ini ditampilkan browser web.

void Refresh();

Keterangan

Refresh tidak berisi parameter untuk mengatur tingkat refresh.

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::Refresh2

Memuat ulang file yang sedang ditampilkan Internet Explorer.

void Refresh2(int nLevel);

Parameter

nLevel
Alamat variabel yang menentukan tingkat refresh. Variabel yang mungkin didefinisikan dalam RefreshConstants, di Windows SDK.

Keterangan

Tidak seperti Refresh, Refresh2 berisi parameter yang menentukan tingkat refresh.

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::SetAddressBar

Panggil fungsi anggota ini untuk menampilkan atau menyembunyikan bilah alamat objek Internet Explorer.

void SetAddressBar(BOOL bNewValue);

Parameter

bNewValue
Bukan nol untuk menampilkan bilah alamat; jika tidak, nol.

Keterangan

Berlaku untuk Internet Explorer. Jika Anda menggunakan panggilan ini dengan kontrol WebBrowser, itu tidak akan mengembalikan kesalahan, tetapi akan mengabaikan panggilan ini.

CHtmlView::SetFullScreen

Panggil fungsi anggota ini untuk menyetel Internet Explorer ke mode jendela layar penuh atau normal.

void SetFullScreen(BOOL bNewValue);

Parameter

bNewValue
Nonzero untuk mode layar penuh; jika tidak, nol.

Keterangan

Dalam mode layar penuh, jendela utama Internet Explorer dimaksimalkan dan bilah status, toolbar, bilah menu, dan bilah judul disembunyikan.

Berlaku untuk Internet Explorer. Jika Anda menggunakan panggilan ini dengan kontrol WebBrowser, itu tidak akan mengembalikan kesalahan, tetapi akan mengabaikan panggilan ini.

CHtmlView::SetHeight

Panggil fungsi anggota ini untuk menyetel tinggi jendela utama Internet Explorer.

void SetHeight(long nNewValue);

Parameter

nNewValue
Tinggi, dalam piksel, dari jendela utama.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::SetLeft

Menyetel posisi horizontal jendela utama Internet Explorer.

void SetLeft(long nNewValue);

Parameter

nNewValue
Koordinat layar tepi kiri jendela utama.

CHtmlView::SetMenuBar

Panggil fungsi anggota ini untuk menampilkan atau menyembunyikan bilah menu Internet Explorer.

void SetMenuBar(BOOL bNewValue);

Parameter

bNewValue
Bukan nol untuk menampilkan bilah menu; jika tidak, nol.

Keterangan

Berlaku untuk Internet Explorer. Jika Anda menggunakan panggilan ini dengan kontrol WebBrowser, itu tidak akan mengembalikan kesalahan, tetapi akan mengabaikan panggilan ini.

CHtmlView::SetOffline

Panggil fungsi anggota ini untuk menetapkan nilai yang menunjukkan apakah kontrol WebBrowser saat ini beroperasi dalam mode offline.

void SetOffline(BOOL bNewValue);

Parameter

bNewValue
Nonzero untuk dibaca dari cache lokal; jika tidak, nol.

Keterangan

Dalam mode offline, browser membaca halaman HTML dari cache lokal daripada dari dokumen sumber.

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::SetRegisterAsBrowser

Panggil fungsi anggota ini untuk menetapkan nilai yang menunjukkan apakah kontrol WebBrowser terdaftar sebagai browser tingkat atas untuk resolusi nama target.

void SetRegisterAsBrowser(BOOL bNewValue);

Parameter

bNewValue
Menentukan apakah Internet Explorer terdaftar sebagai browser tingkat atas. Jika bukan nol, browser web terdaftar sebagai browser tingkat atas; jika nol, ini bukan browser tingkat atas. Nilai defaultnya adalah nol.

Keterangan

Browser tingkat atas adalah browser yang diatur dalam registri sebagai browser default.

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::SetRegisterAsDropTarget

Panggil fungsi anggota ini untuk menetapkan nilai yang menunjukkan apakah kontrol WebBrowser terdaftar sebagai target penurunan untuk navigasi.

void SetRegisterAsDropTarget(BOOL bNewValue);

Parameter

bNewValue
Menentukan apakah kontrol WebBrowser terdaftar sebagai target penurunan untuk navigasi. Jika bukan nol, objek didaftarkan sebagai target penurunan; jika nol, itu bukan target penurunan.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::SetSilent

Panggil fungsi anggota ini untuk mengatur nilai yang menunjukkan apakah ada kotak dialog yang dapat ditampilkan.

void SetSilent(BOOL bNewValue);

Parameter

bNewValue
Jika bukan nol, kotak dialog tidak akan ditampilkan; jika nol, kotak dialog akan ditampilkan. Nilai defaultnya adalah nol.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::SetStatusBar

Panggil fungsi anggota ini untuk menampilkan bilah status.

void SetStatusBar(BOOL bNewValue);

Parameter

bNewValue
Bukan nol jika bilah status terlihat; jika tidak, nol.

Keterangan

Berlaku untuk Internet Explorer. Jika Anda menggunakan panggilan ini dengan kontrol WebBrowser, itu tidak akan mengembalikan kesalahan, tetapi akan mengabaikan panggilan ini.

CHtmlView::SetTheaterMode

Panggil fungsi anggota ini untuk mengatur nilai yang menunjukkan apakah kontrol WebBrowser berada dalam mode bioskop.

void SetTheaterMode(BOOL bNewValue);

Parameter

bNewValue
Nonzero untuk mengatur kontrol WebBrowser ke mode teaer; jika tidak, nol. Nilai defaultnya adalah nol.

Keterangan

Saat browser web dalam mode teater, jendela utama browser mengisi seluruh layar, toolbar dengan sekumpulan alat navigasi minimal muncul, dan bilah status muncul di sudut kanan atas layar.

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::SetToolBar

Panggil fungsi anggota ini untuk menampilkan atau menyembunyikan bilah alat Internet Explorer.

void SetToolBar(int nNewValue);

Parameter

nNewValue
Menunjukkan apakah akan menampilkan bilah alat. Bukan nol jika toolbar akan ditampilkan; jika tidak, nol.

Keterangan

Berlaku untuk Internet Explorer. Jika Anda menggunakan panggilan ini dengan kontrol WebBrowser, itu tidak akan mengembalikan kesalahan, tetapi akan mengabaikan panggilan ini.

CHtmlView::SetTop

Panggil fungsi anggota ini untuk mengatur jarak antara tepi atas internal kontrol WebBrowser dan tepi atas kontainernya

void SetTop(long nNewValue);

Parameter

nNewValue
Koordinat layar tepi atas jendela utama.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::SetVisible

Panggil fungsi anggota ini untuk mengatur status visibilitas kontrol WebBrowser.

void SetVisible(BOOL bNewValue);

Parameter

bNewValue
Bukan nol jika kontrol terlihat; jika tidak, nol.

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

CHtmlView::SetWidth

Menyetel lebar jendela utama Internet Explorer.

void SetWidth(long nNewValue);

Parameter

nNewValue
Lebar, dalam piksel, dari jendela utama Internet Explorer.

CHtmlView::Stop

Panggil fungsi anggota ini untuk membatalkan navigasi tertunda atau operasi pengunduhan dan menghentikan elemen halaman dinamis apa pun, seperti suara latar belakang dan animasi.

void Stop();

Keterangan

Berlaku untuk Internet Explorer dan WebBrowser.

Lihat juga

Sampel MFC MFCIE
CFormView class
Bagan hierarki
IWebBrowser2