CHtmlView 類別

在 MFC 的文件/檢視架構內容中提供 WebBrowser 控制項的功能。

語法

class CHtmlView : public CFormView

成員

公用方法

名稱	描述
CHtmlView::Create	建立 WebBrowser 控制項。
CHtmlView::CreateControlSite	可覆寫，用來建立主控表單上之控制項的控制項網站執行個體。
CHtmlView::ExecFormsCommand	使用 IOleCommandTarget::Exec 方法執行指定的命令。
CHtmlView::ExecWB	執行命令。
CHtmlView::GetAddressBar	決定是否顯示 Internet Explorer 物件的網址列。 (忽略　WebBrowser 控制項，僅限 Internet Explorer。)
CHtmlView::GetApplication	擷取代表應用程式的應用程式物件，此應用程式包含 Internet Explorer 應用程式目前的執行個體。
CHtmlView::GetBusy	擷取指出下載或其他活動是否仍在進行中的值。
CHtmlView::GetContainer	擷取 WebBrowser 控制項的容器。
CHtmlView::GetFullName	擷取顯示在網頁瀏覽器中的資源完整名稱，包括路徑。 (忽略　WebBrowser 控制項，僅限 Internet Explorer。)
CHtmlView::GetFullScreen	指出 WebBrowser 控制項是在全螢幕模式或標準視窗模式中操作。
CHtmlView::GetHeight	擷取 Internet Explorer 主視窗的高度。
CHtmlView::GetHtmlDocument	擷取使用中的 HTML 文件。
CHtmlView::GetLeft	擷取 Internet Explorer 主視窗左邊緣的螢幕座標。
CHtmlView::GetLocationName	擷取 WebBrowser 目前顯示的資源名稱。
CHtmlView::GetLocationURL	擷取 WebBrowser 目前顯示的資源 URL。
CHtmlView::GetMenuBar	擷取決定是否顯示功能表列的值。
CHtmlView::GetOffline	擷取決定控制項是否離線的值。
CHtmlView::GetParentBrowser	擷取 IDispatch 介面的指標。 如需詳細資訊，請參閱 實作 IDispatch 介面。
CHtmlView::GetProperty	擷取與指定物件相關聯屬性目前的值。
CHtmlView::GetReadyState	擷取網頁瀏覽器物件的就緒狀態。
CHtmlView::GetRegisterAsBrowser	指出 WebBrowser 控制項是否註冊為目標名稱解析的最上層瀏覽器進行。
CHtmlView::GetRegisterAsDropTarget	指出 WebBrowser 控制項是否註冊為巡覽的置放目標。
CHtmlView::GetSilent	指出是否可顯示所有對話方塊。
CHtmlView::GetSource	網頁的 HTML 原始程式碼。
CHtmlView::GetStatusBar	指出是否顯示 Internet Explorer 狀態列。 (忽略　WebBrowser 控制項，僅限 Internet Explorer。)
CHtmlView::GetTheaterMode	指出 WebBrowser 控制項是否為劇場模式。
CHtmlView::GetToolBar	擷取決定是否顯示工具列的值。
CHtmlView::GetTop	擷取 Internet Explorer 主視窗上邊緣的螢幕座標。
CHtmlView::GetTopLevelContainer	擷取值，指出目前的物件是否為 WebBrowser 控制項的最上層容器。
CHtmlView::GetType	擷取文件物件的類型名稱。
CHtmlView::GetVisible	擷取指出物件為顯示或隱藏的值。
CHtmlView::GetWidth	擷取 Internet Explorer 主視窗的寬度。
CHtmlView::GoBack	在歷程清單中巡覽至上一個項目。
CHtmlView::GoForward	在歷程清單中巡覽至下一個項目。
CHtmlView::GoHome	巡覽至目前的首頁或起始頁面。
CHtmlView::GoSearch	巡覽至目前的搜尋頁面。
CHtmlView::LoadFromResource	載入 WebBrowser 控制項的資源。
CHtmlView::Navigate	巡覽至依 URL 找到的資源。
CHtmlView::Navigate2	巡覽至依 URL 找到的資源或依完整路徑找到的檔案。
CHtmlView::OnBeforeNavigate2	在指定的 WebBrowser 中發生瀏覽作業之前呼叫 （在視窗或框架集專案上）。
CHtmlView::OnCommandStateChange	呼叫以通知應用程式， 網頁瀏覽器命令啟用的狀態已經變更。
CHtmlView::OnDocumentComplete	呼叫以通知應用程式，文件已達到 READYSTATE_COMPLETE 狀態。
CHtmlView::OnDocWindowActivate	從的 IOleInPlaceActiveObject::OnDocWindowActivateInternet Explorer 或 MSHTML 實作呼叫，這會在容器的文檔窗口啟動或停用時通知使用中的就地物件。
CHtmlView::OnDownloadBegin	呼叫以通知應用程式，巡覽作業已經啟動。
CHtmlView::OnDownloadComplete	當巡覽作業結束、暫止或失敗時呼叫。
CHtmlView::OnEnableModeless	當容器建立或終結強制回應對話方塊時，呼叫以啟用或停用非強制回應對話方塊。
CHtmlView::OnFilterDataObject	Internet Explorer 或 MSHTML 在主機上呼叫，允許主機替換 Internet Explorer 或 MSHTML 的資料物件。
CHtmlView::OnFrameWindowActivate	從 IOleInPlaceActiveObject::OnFrameWindowActivate 呼叫，以在容器的最上層框架窗口啟動或停用時通知物件。
CHtmlView::OnFullScreen	當屬性變更時 FullScreen 呼叫。
CHtmlView::OnGetDropTarget	當 Internet Explorer 或 MSHTML 作為置放目標時，由 Internet Explorer 或 MSHTML 呼叫，以允許主機提供替代 IDropTarget的 。
CHtmlView::OnGetExternal	由 Internet Explorer 或 MSHTML 呼叫，以取得主機的 IDispatch 介面。
CHtmlView::OnGetHostInfo	擷取 Internet Explorer 或 MSHTML 主機的 UI 功能。
CHtmlView::OnGetOptionKeyPath	傳回 Internet Explorer 或 MSHTML 儲存使用者喜好設定的登錄機碼。
CHtmlView::OnHideUI	當 Internet Explorer 或 MSHTML 移除其功能表與工具列時呼叫。
CHtmlView::OnMenuBar	當屬性變更時 MenuBar 呼叫。
CHtmlView::OnNavigateComplete2	流覽至超連結完成之後呼叫 （在視窗或框架集專案上）。
CHtmlView::OnNavigateError	巡覽至超連結失敗時，由架構呼叫。
CHtmlView::OnNewWindow2	當為顯示資源而建立新視窗時呼叫。
CHtmlView::OnProgressChange	呼叫以通知應用程式，下載作業的進度已經更新。
CHtmlView::OnPropertyChange	呼叫 以通知應用程式 PutProperty 方法已變更屬性的值。
CHtmlView::OnQuit	呼叫以通知應用程式，Internet Explorer 應用程式已經可以結束。 (僅限 Internet Explorer)
CHtmlView::OnResizeBorder	從的 IOleInPlaceActiveObject::ResizeBorderInternet Explorer 或 MSHTML 實作呼叫，它會警示物件需要調整其框線空間的大小。
CHtmlView::OnShowContextMenu	即將顯示其操作功能表時，從 Internet Explorer 或 MSHTML 呼叫。
CHtmlView::OnShowUI	在 Internet Explorer 或 MSHTML 顯示其功能表與工具列之前呼叫。
CHtmlView::OnStatusBar	當屬性變更時 StatusBar 呼叫。
CHtmlView::OnStatusTextChange	呼叫以通知應用程式，和 WebBrowser 控制項相關的狀態列文字已經變更。
CHtmlView::OnTheaterMode	當屬性變更時 TheaterMode 呼叫。
CHtmlView::OnTitleChange	呼叫以通知應用程式，WebBrowser 控制項中文件的標題是否變成可用或變更。
CHtmlView::OnToolBar	當屬性變更時 ToolBar 呼叫。
CHtmlView::OnTranslateAccelerator	呼叫 Internet Explorer 或 MSHTML，以處理來自容器消息佇列的功能表快捷鍵訊息時IOleInPlaceActiveObject::TranslateAcceleratorIOleControlSite::TranslateAccelerator或 MSHTML 呼叫。
CHtmlView::OnTranslateUrl	由 Internet Explorer 或 MSHTML 呼叫，讓主機有機會修改要載入的 URL。
CHtmlView::OnUpdateUI	通知主機命令狀態已變更。
CHtmlView::OnVisible	當 WebBrowser 控制項的視窗必須顯示/隱藏時呼叫。
CHtmlView::PutProperty	設定與指定物件相關聯屬性的值。
CHtmlView::QueryFormsCommand	查詢使用者介面事件所產生之一或多個命令的狀態。
CHtmlView::QueryStatusWB	查詢 WebBrowser 控制項處理中的命令狀態。
CHtmlView::Refresh	重新載入目前的檔案。
CHtmlView::Refresh2	重新載入目前的檔案，並選擇性地防止傳送 pragma:nocache 標頭。
CHtmlView::SetAddressBar	顯示或隱藏 Internet Explorer 物件的網址列。 (忽略　WebBrowser 控制項，僅限 Internet Explorer。)
CHtmlView::SetFullScreen	設定值以決定控制項在全螢幕模式或標準視窗模式中操作。 (忽略　WebBrowser 控制項，僅限 Internet Explorer。)
CHtmlView::SetHeight	設定 Internet Explorer 主視窗的高度。
CHtmlView::SetLeft	設定 Internet Explorer 主視窗的水平位置。
CHtmlView::SetMenuBar	設定決定是否顯示控制項功能表列的值。 (忽略　WebBrowser 控制項，僅限 Internet Explorer。)
CHtmlView::SetOffline	設定決定控制項是否離線的值。
CHtmlView::SetRegisterAsBrowser	設定值，指出 WebBrowser 控制項是否註冊為目標名稱解析的最上層瀏覽器。
CHtmlView::SetRegisterAsDropTarget	設定值，指出 WebBrowser 控制項是否註冊為巡覽的置放目標。
CHtmlView::SetSilent	設定決定控制項是否顯示對話方塊的值。
CHtmlView::SetStatusBar	設定值，決定是否顯示 Internet Explorer 狀態列。 (忽略　WebBrowser 控制項，僅限 Internet Explorer。)
CHtmlView::SetTheaterMode	設定指出 WebBrowser 控制項是否為劇場模式的值。
CHtmlView::SetToolBar	設定決定是否顯示控制項工具列的值。 (忽略　WebBrowser 控制項，僅限 Internet Explorer。)
CHtmlView::SetTop	設定 Internet Explorer 主視窗的垂直位置。
CHtmlView::SetVisible	設定指出物件為顯示或隱藏的值。
CHtmlView::SetWidth	設定 Internet Explorer 主視窗的寬度。
CHtmlView::Stop	停止開啟檔案。

備註

WebBrowser 控件是一個視窗，用戶可以在萬維網上瀏覽網站，以及本機檔系統和網路上的資料夾。 WebBrowser 控制項支援超連結和統一資源定位器 (URL) 巡覽，以及維護歷程記錄清單。

CHtmlView在 MFC 應用程式中使用 類別

在標準的 MFC 架構應用程式中 (SDI 或 MDI 型)，檢視物件通常衍生自一組特製的類別。 這些類別全都衍生自 CView，除 CView提供的功能之外，還提供特製的功能。

以 CHtmlView 當做應用程式檢視類別的基礎，可以提供附有 WebBrowser 控制項的檢視。 這能讓應用程式變成網頁瀏覽器。 建立網頁瀏覽器型應用程式的慣用方法，是使用 [MFC 應用程式精靈]，指定 CHtmlView 為檢視類別。 如需在 MFC 應用程式中實作及使用 WebBrowser 控制項的詳細資訊，請參閱 建立網頁瀏覽器型的應用程式。

注意

WebBrowser ActiveX 控制項 (亦即 CHtmlView) 僅適用於已安裝 Internet Explorer 4.0 或更新版本的 Windows NT 4.0 或更新版本中所執行的程式。

CHtmlView 是為存取 Web (和/或 HTML 文件) 的應用程式所設計。 下列 CHtmlView 成員函式僅適用於 Internet Explorer 應用程式。 這些函式會在 WebBrowser 控制項上成功，但不會有任何明顯的效果。

• GetAddressBar
• GetFullName
• GetStatusBar
• SetAddressBar
• SetFullScreen
• SetMenuBar
• SetStatusBar
• SetToolBar

繼承階層架構

CObject
CCmdTarget
CWnd
CView
CScrollView
CFormView

CHtmlView

需求

標頭： afxhtml.h

CHtmlView::Create

呼叫這個成員函式，以建立 Internet Explorer 可執行檔的 WebBrowser 控制件或容器。

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

參數

lpszClassName
指向命名 Windows 類別的 Null 終止字元字串。 類別名稱可以是向 AfxRegisterWndClass 全域函式或 RegisterClass Windows 函式註冊的任何名稱。 如果 NULL為 ，則使用預先定義的預設 CFrameWnd 屬性。

lpszWindowName
指向代表視窗名稱的 Null 終止字元字串。

dwStyle
指定視窗樣式屬性。 根據預設， WS_VISIBLE 會設定 和 WS_CHILD Windows 樣式。

rect
指定視窗大小和位置之 結構的參考 RECT 。 值 rectDefault 可讓 Windows 指定新視窗的大小和位置。

pParentWnd
控件父視窗的指標。

nID
檢視的標識碼。 根據預設，設定為 AFX_IDW_PANE_FIRST。

pContext
的 CCreateContext指標。 預設為 NULL。

CHtmlView::CreateControlSite

可覆寫，用來建立主控表單上之控制項的控制項網站執行個體。

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

參數

pContainer
包含控件之 物件的指標 COleControlContainer 。

ppSite
物件的指標 COleControlSite ，提供控件的月臺。

nID
要裝載之控件的標識碼。

clsid
要裝載之控件的CLSID

傳回值

成功時傳回 TRUE，失敗時則傳回 FALSE。

備註

您可以覆寫這個成員函式，以傳回您自己的控件網站類別實例。

CHtmlView::ExecFormsCommand

使用 IOleCommandTarget::Exec 方法執行指定的命令。

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

參數

dwCommandID
要執行的命令。 此命令必須屬於 CMDSETID3_Forms3 群組。

pVarIn
VARIANT包含輸入自變數之結構的指標。 可以是 NULL。

pVarOut
VARIANT要接收命令輸出之結構的指標。 可以是 NULL。

傳回值

標準 HRESULT 值。 如需可能值的完整清單，請參閱 IOleCommandTarget::Exec Windows SDK。

備註

ExecFormsCommand 會實作 方法的行為 IOleCommandTarget::Exec 。

CHtmlView::ExecWB

呼叫此成員函式，以在 WebBrowser 或 Internet Explorer 中執行命令。

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

參數

cmdID
要執行的命令。

cmdexecopt
設定執行命令的選項。

pvaIn
用來指定命令輸入自變數的變體。

pvaOut
用於指定命令輸出自變數的變體。

備註

請參閱 IWebBrowser2::ExecWB Windows SDK。

CHtmlView::GetAddressBar

呼叫此成員函式以擷取 Internet Explorer 的網址列。

BOOL GetAddressBar() const;

傳回值

如果網址列可見，則為非零;否則為零。

備註

適用於 Internet Explorer。 如果您使用此呼叫搭配 WebBrowser 控件，則不會傳回錯誤，但會忽略此呼叫。

CHtmlView::GetApplication

呼叫這個成員函式，以擷取包含 WebBrowser 控件的應用程式所支援的自動化物件。

LPDISPATCH GetApplication() const;

傳回值

使用中檔對象的介面指標 IDispatch 。 如需詳細資訊，請參閱 實作 IDispatch 介面。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GetBusy

呼叫此成員函式，以判斷 WebBrowser 控件是否參與瀏覽或下載作業。

BOOL GetBusy() const;

傳回值

如果網頁瀏覽器忙碌，則為非零;否則為零。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GetContainer

呼叫這個成員函式，以擷取評估為網頁瀏覽器容器的物件。

LPDISPATCH GetContainer() const;

傳回值

使用中檔對象的介面指標 IDispatch 。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GetFullName

呼叫這個成員函式，以擷取 Internet Explorer 目前顯示之檔案的完整路徑。

CString GetFullName() const;

傳回值

CString物件，包含目前顯示之檔案的路徑和名稱。 如果沒有路徑與檔案名存在， GetFullName 則會傳回空 CString的 。

備註

適用於 Internet Explorer。 如果您使用此呼叫搭配 WebBrowser 控件，則不會傳回錯誤，但會忽略此呼叫。

CHtmlView::GetFullScreen

呼叫這個成員函式，以判斷 WebBrowser 控件是以全螢幕模式或正常視窗模式運作。

BOOL GetFullScreen() const;

傳回值

如果 WebBrowser 以全螢幕模式運作，則為非零;否則為零。

備註

在全螢幕模式中，Internet Explorer 主視窗會最大化，並隱藏狀態列、工具列、功能表欄和標題列。

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GetHeight

呼叫這個成員函式，以像素為單位擷取 WebBrowser 控件框架視窗的高度。

long GetHeight() const;

傳回值

控件的框架視窗高度，以像素為單位。

CHtmlView::GetHtmlDocument

呼叫這個成員函式，以擷取使用中檔的 HTML 檔。

LPDISPATCH GetHtmlDocument() const;

傳回值

使用中檔對象的介面指標 IDispatch 。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GetLeft

呼叫這個成員函式，以擷取 WebBrowser 控件內部邊緣與其容器左邊緣之間的距離。

long GetLeft() const;

傳回值

左邊緣距離，以像素為單位。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GetLocationName

呼叫此成員函式，以取得 WebBrowser 中顯示的資源名稱。

CString GetLocationName() const;

傳回值

CString物件，包含目前顯示在 WebBrowser 中的資源名稱。

備註

如果資源是萬維網上的 HTML 頁面，該名稱就是該頁面的標題。 如果資源是網路或本機計算機上的資料夾或檔案，則名稱為資料夾或檔案的 UNC 或完整路徑。

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GetLocationURL

呼叫這個成員函式，以擷取 WebBrowser 控件目前顯示的資源 URL。

CString GetLocationURL() const;

傳回值

CString物件，包含目前顯示在 WebBrowser 中的資源 URL。

備註

如果資源是網路或本機計算機上的資料夾或檔案，則名稱為資料夾或檔案的 UNC 或完整路徑。

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GetMenuBar

呼叫這個成員函式，以判斷功能表欄是否可見。

BOOL GetMenuBar() const;

傳回值

如果功能表欄可見，則為非零;否則為零。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GetOffline

呼叫此成員函式，以判斷網頁瀏覽器是否脫機運作。

BOOL GetOffline() const;

傳回值

如果網頁瀏覽器目前離線，則為非零;否則為零。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GetParentBrowser

呼叫這個成員函式，以擷取 WebBrowser 控件之父物件的指標。

LPDISPATCH GetParentBrowser() const;

傳回值

對象的介面指標 IDispatch ，該物件是WebBrowser控件的父系。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GetProperty

呼叫這個成員函式，以取得目前與控件相關聯的屬性值。

BOOL GetProperty(
    LPCTSTR lpszProperty,
    CString& strValue);

COleVariant GetProperty(LPCTSTR lpszProperty);

參數

lpszProperty
字串的指標，其中包含要擷取的屬性。

strValue
對象的參考 CString ，這個物件會接收 屬性的目前值。

傳回值

在第一個版本中，如果成功完成，則為非零;否則為零。 在第二個版本中，物件 COleVariant 。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GetReadyState

呼叫這個成員函式以擷取 WebBrowser 物件的就緒狀態。

READYSTATE GetReadyState() const;

傳回值

值 READYSTATE ，如 Windows SDK 中所述。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GetRegisterAsBrowser

呼叫這個成員函式，以判斷 WebBrowser 物件是否註冊為目標名稱解析的最上層瀏覽器。

BOOL GetRegisterAsBrowser() const;

傳回值

如果瀏覽器註冊為最上層瀏覽器，則為非零;否則為零。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GetRegisterAsDropTarget

呼叫這個成員函式，以判斷 WebBrowser 控件是否註冊為流覽的置放目標。

BOOL GetRegisterAsDropTarget() const;

傳回值

如果瀏覽器註冊為置放目標，則為非零;否則為零。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GetSilent

呼叫這個成員函式，以判斷 WebBrowser 控件中是否可以顯示任何對話方塊。

BOOL GetSilent() const;

傳回值

如果無法從 WebBrowser 控制件顯示對話框，則為非零;否則為零。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GetSource

呼叫這個成員函式以擷取網頁的HTML原始程式碼。

BOOL GetSource(CString& strRef);

傳回值

如果成功則不為零，否則為 0。

參數

refString
CString儲存原始碼的 。

備註

此函式相當於 Internet Explorer 中的 「檢視來源」命令，不同之處在於原始程式碼是在 中 CString傳回。

CHtmlView::GetStatusBar

呼叫這個成員函式，以判斷 WebBrowser 控件是否顯示狀態列。

BOOL GetStatusBar() const;

傳回值

如果狀態列可以顯示，則為非零;否則為零。

備註

適用於 Internet Explorer。 如果您使用此呼叫搭配 WebBrowser 控件，則不會傳回錯誤，但會忽略此呼叫。

CHtmlView::GetTheaterMode

呼叫此成員函式，以判斷網頁瀏覽器是否處於劇院模式。

BOOL GetTheaterMode() const;

傳回值

如果網頁瀏覽器處於劇院模式，則為非零;否則為零。

備註

當網頁瀏覽器處於劇院模式時，瀏覽器主視窗會填滿整個畫面、一組最少導覽工具的工具列隨即出現，而狀態列會出現在畫面右上角。

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GetToolBar

呼叫這個成員函式，以判斷工具列是否可見。

int GetToolBar() const;

傳回值

值，指出工具列是否可見。 如果顯示工具列，則為非零;否則為零。

CHtmlView::GetTop

呼叫這個成員函式，以擷取 WebBrowser 控件主視窗上邊緣的螢幕座標。

long GetTop() const;

傳回值

接收主視窗上邊緣螢幕座標的變數位址。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GetTopLevelContainer

呼叫這個成員函式，以判斷 Internet Explorer 是否為 WebBrowser 控件的最上層容器。

BOOL GetTopLevelContainer() const;

傳回值

非零容器是最上層容器;否則為零。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GetType

呼叫這個成員函式，以擷取包含之使用中檔的型別名稱。

CString GetType() const;

傳回值

CString物件，包含包含使用中檔的類型名稱。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GetVisible

呼叫這個成員函式，以判斷自主物件是否可見。

BOOL GetVisible() const;

傳回值

如果對象可見，則為非零;否則為零。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GetWidth

擷取 Internet Explorer 主視窗的寬度。

long GetWidth() const;

傳回值

視窗的目前寬度，以像素為單位。

CHtmlView::GoBack

在歷程記錄清單中向後巡覽一個專案。

void GoBack();

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GoForward

在歷程記錄清單中向前巡覽一個專案。

void GoForward();

CHtmlView::GoHome

巡覽至目前的首頁或起始頁，這是在 Internet Explorer [網際網路選項] 對話方塊或 [網際網路內容] 對話方塊中指定，從控制台存取。

void GoHome();

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::GoSearch

巡覽至目前的搜尋頁面，如 Internet Explorer Internet Options 對話框或因特網屬性對話框中所指定，可從 控制台 存取。

void GoSearch();

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::LoadFromResource

呼叫這個成員函式，將指定的資源載入 WebBrowser 控件。

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

參數

lpszResource
字串的指標，其中包含要載入的資源名稱。

nRes
緩衝區的標識碼，其中包含要載入的資源名稱。

傳回值

如果成功則不為零，否則為 0。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::Navigate

呼叫此成員函式以流覽至URL所識別的資源。

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

參數

URL
呼叫端配置的字串，其中包含要巡覽至的URL，或要顯示之檔案的完整路徑。

dwFlags
變數的旗標，指定是否要將資源新增至歷程記錄清單、是否要從快取讀取或寫入，以及是否要在新的視窗中顯示資源。 變數可以是 列舉所 BrowserNavConstants 定義的值組合。

lpszTargetFrameName
字串的指標，其中包含要在其中顯示資源的框架名稱。

lpszHeaders
值的指標，指定要傳送至伺服器的 HTTP 標頭。 這些標頭會新增至預設 Internet Explorer 標頭。 標頭可以指定這類專案，例如伺服器所需的動作、要傳遞至伺服器的數據類型，或狀態代碼。 如果 URL 不是 HTTP URL，則會忽略此參數。

lpvPostData
要與 HTTP POST 交易一起傳送之數據的指標。 例如，POST 交易是用來傳送 HTML 窗體所收集的數據。 如果此參數未指定任何張貼數據， Navigate 請發出 HTTP GET 交易。 如果 URL 不是 HTTP URL，則會忽略此參數。

dwPostDataLen
要與 HTTP POST 交易一起傳送的數據。 例如，POST 交易是用來傳送 HTML 窗體所收集的數據。 如果此參數未指定任何張貼數據， Navigate 請發出 HTTP GET 交易。 如果 URL 不是 HTTP URL，則會忽略此參數。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::Navigate2

呼叫此成員函式以巡覽至 URL 所識別的資源，或巡覽至完整路徑所識別的檔案。

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);

參數

pIDL
結構的指標 ITEMIDLIST 。

dwFlags
變數的旗標，指定是否要將資源新增至歷程記錄清單、是否要從快取讀取或寫入，以及是否要在新的視窗中顯示資源。 變數可以是 列舉所 BrowserNavConstants 定義的值組合。

lpszTargetFrameName
字串的指標，其中包含要在其中顯示資源的框架名稱。

lpszURL
字串的指標，其中包含 URL。

lpvPostData
要與 HTTP POST 交易一起傳送的數據。 例如，POST 交易是用來傳送 HTML 窗體所收集的數據。 如果此參數未指定任何張貼數據， Navigate2 請發出 HTTP GET 交易。 如果 URL 不是 HTTP 或 HTTPS URL，則會忽略此參數。

dwPostDataLen
參數所 lpvPostData 指向之數據的位元組長度。

lpszHeaders
值的指標，指定要傳送至伺服器的 HTTP 或 HTTPS 標頭。 這些標頭會新增至預設 Internet Explorer 標頭。 標頭可以指定這類專案，例如伺服器所需的動作、要傳遞至伺服器的數據類型，或狀態代碼。 如果 URL 不是 HTTP 或 HTTPS URL，則會忽略此參數。

baPostedData
對 CByteArray 物件的參考。

備註

此成員函式支援瀏覽以 參數 表示的特殊資料夾，例如桌面和我的計算機，來擴充 Navigate 成員函式 pIDL。

適用於 Internet Explorer 和 WebBrowser。

範例

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

CHtmlView::OnBeforeNavigate2

架構會呼叫此成員函式，以在網頁瀏覽器中發生巡覽作業之前引發事件。

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

參數

lpszURL
字串的指標，其中包含要巡覽至的URL。

nFlags
保留供未來使用。

lpszTargetFrameName
字串，包含要在其中顯示資源的框架名稱，如果沒有 NULL 針對資源設定任何具名框架，則為 。

baPostedData
對象的參考 CByteArray ，其中包含在使用 HTTP POST 交易時要傳送至伺服器的數據。

lpszHeaders
字串的指標，包含要傳送至伺服器的其他 HTTP 標頭（僅限 HTTP URL）。 標頭可以指定這類專案，例如伺服器所需的動作、要傳遞至伺服器的數據類型，或狀態代碼。

pbCancel
取消旗標的指標。 應用程式可以將此參數設定為非零，以取消瀏覽作業，或設定為零以允許它繼續。

CHtmlView::OnCommandStateChange

架構會呼叫此成員函式，以通知應用程式網頁瀏覽器命令已啟用的狀態已變更。

virtual void OnCommandStateChange(
    long nCommand,
    BOOL bEnable);

參數

nCommand
已啟用狀態已變更之命令的標識碼。

bEnable
已啟用狀態。 如果已啟用命令，則此參數為非零，如果已停用，則為零。

CHtmlView::OnDocumentComplete

架構會呼叫此成員函式，以通知應用程式檔已到達 READYSTATE_COMPLETE 狀態。

virtual void OnDocumentComplete(LPCTSTR lpszURL);

參數

lpszURL
評估為 URL、UNC 檔名或 PIDL（專案識別子清單指標）的字串指標，該字串已巡覽至 。

備註

並非每個畫面都會引發此事件，但引發事件的每個框架 OnDownloadBegin 都會引發對應的 OnDocumentComplete 事件。

所 lpszURL 指示的 URL 與瀏覽器被告知要流覽的 URL 不同，因為此 URL 是正式化且合格的 URL。 例如，如果應用程式在呼叫 Navigate 或 中指定的"www.microsoft.com"網址，則所OnNavigateComplete2傳遞的網址會是 "<https://www.microsoft.com/>"Navigate2。 此外，如果伺服器已將瀏覽器重新導向至不同的 URL，則會在這裡反映重新導向的 URL。

CHtmlView::OnDocWindowActivate

從的 IOleInPlaceActiveObject::OnDocWindowActivateInternet Explorer 或 MSHTML 實作呼叫，這會在容器的文檔窗口啟動或停用時通知使用中的就地物件。

virtual HRESULT OnDocWindowActivate(BOOL fActivate);

參數

fActivate
指出文件窗口的狀態。 如果此值為非零值，則會啟動視窗。 如果此值為零，則會停用視窗。

傳回值

S_OK 如果成功，則為 ，否則為 OLE 定義的錯誤碼。

備註

覆寫 OnDocWindowActivate 以回應 OnDocWindowActivate 來自 Microsoft 網頁瀏覽器控件的通知。 如需詳細資訊，請參閱 IDocHostUIHandler::OnDocWindowActivate Windows SDK。

CHtmlView::OnDownloadBegin

架構會呼叫此成員函式以開始下載檔。

virtual void OnDownloadBegin();

備註

除非取消導覽，否則事件會在事件之後 OnBeforeNavigate2 不久引發此事件。 任何動畫或「忙碌」指示，容器必須顯示應該連接到此事件。

CHtmlView::OnDownloadComplete

架構會呼叫此成員函式，指出巡覽作業已完成、已停止或失敗。

virtual void OnDownloadComplete();

CHtmlView::OnEnableModeless

當 Internet Explorer 或 MSHTML 顯示強制回應 UI 時呼叫。

virtual HRESULT OnEnableModeless(BOOL fEnable);

參數

fEnable
指出主機的無模式對話框是否已啟用或停用。 如果此值為非零值，則會啟用無模式對話方塊。 如果此值為零，則會停用無模式對話框。

傳回值

S_OK 如果成功，則為 ，否則為 OLE 定義的錯誤碼。

備註

當容器建立或終結強制回應對話框時，啟用或停用無模式對話方塊。 覆寫 OnEnableModeless 以回應 EnableModeless 來自 Microsoft 網頁瀏覽器控件的通知。 如需詳細資訊，請參閱 IDocHostUIHandler::EnableModeless Windows SDK。

CHtmlView::OnFilterDataObject

Internet Explorer 或 MSHTML 在主機上呼叫，允許主機替換 Internet Explorer 或 MSHTML 的資料物件。

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

參數

pDataObject
IDataObject Internet Explorer 或 MSHTML 所提供的介面位址。

ppDataObject
接收 IDataObject 主機所提供介面指標的位址。 即使方法失敗，此參數的內容也應該一律初始化為 NULL。

傳回值

S_OK 如果取代資料物件、 S_FALSE 未取代資料物件，或發生錯誤時，則為 OLE 定義的錯誤碼。

備註

覆寫 OnFilterDataObject 以回應 FilterDataObject 來自 Microsoft 網頁瀏覽器控件的通知。 如需詳細資訊，請參閱 IDocHostUIHandler::FilterDataObject Windows SDK。

CHtmlView::OnFrameWindowActivate

從 IOleInPlaceActiveObject::OnFrameWindowActivate 呼叫，以在容器的最上層框架窗口啟動或停用時通知物件。

virtual HRESULT OnFrameWindowActivate(BOOL fActivate);

參數

fActivate
表示容器最上層框架窗口的狀態。 如果此值為非零值，則會啟動視窗。 如果此值為零，則會停用視窗。

傳回值

S_OK 如果成功，則為 ，否則為 OLE 定義的錯誤碼。

備註

覆寫 OnFrameWindowActivate 以回應 OnFrameWindowActivate 來自 Microsoft 網頁瀏覽器控件的通知。 如需詳細資訊，請參閱 IDocHostUIHandler::OnFrameWindowActivate Windows SDK。

CHtmlView::OnFullScreen

當 屬性變更時 FullScreen ，架構會呼叫這個成員函式。

virtual void OnFullScreen(BOOL bFullScreen);

參數

bFullScreen
如果 Internet Explorer 處於全螢幕模式，則為非零;否則為零。

CHtmlView::OnGetDropTarget

當 Internet Explorer 或 MSHTML 作為置放目標時，由 Internet Explorer 或 MSHTML 呼叫，以允許主機提供替代 IDropTarget的 。

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

參數

pDropTarget
IDropTarget Internet Explorer 或 MSHTML 建議使用。

ppDropTarget
IDropTarget位址，接收IDropTarget主機想要提供的介面指標。

傳回值

如需傳回碼清單，請參閱 IDocHostUIHandler::GetDropTarget Windows SDK。

備註

覆寫 OnGetDropTarget 以回應 GetDropTarget 來自 Microsoft 網頁瀏覽器控件的通知。 如需詳細資訊，請參閱 IDocHostUIHandler::GetDropTarget Windows SDK。

CHtmlView::OnGetExternal

由 Internet Explorer 或 MSHTML 呼叫，以取得主機的 IDispatch 介面。

virtual HRESULT OnGetExternal(LPDISPATCH* lppDispatch);

參數

lppDispatch
接收 IDispatch 主應用程式介面指標之位址的指標。 如果主機公開自動化介面，它可以透過此參數提供 Internet Explorer 或 MSHTML 的參考。 即使方法失敗，此參數的內容也應該一律初始化為 NULL。

傳回值

S_OK 如果成功，則為 ，否則為 OLE 定義的錯誤碼。

備註

覆寫 OnGetExternal 以回應 GetExternal 來自 Microsoft 網頁瀏覽器控件的通知。 如需詳細資訊，請參閱 IDocHostUIHandler::GetExternal Windows SDK。

CHtmlView::OnGetHostInfo

擷取 Internet Explorer 或 MSHTML 主機的 UI 功能。

virtual HRESULT OnGetHostInfo(DOCHOSTUIINFO* pInfo);

參數

pInfo
DOCHOSTUIINFO接收主機 UI 功能之結構的位址。

傳回值

S_OK 如果成功，則為 ，否則為 OLE 定義的錯誤碼。

備註

覆寫 OnGetHostInfo 以回應 GetHostInfo 來自 Microsoft 網頁瀏覽器控件的通知。 如需詳細資訊，請參閱 IDocHostUIHandler::GetHostInfo Windows SDK。

CHtmlView::OnGetOptionKeyPath

呼叫此成員函式以取得 Internet Explorer 或 MSHTML 儲存使用者喜好設定所在的登錄機碼。

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

參數

pchKey
LPOLESTR接收主機儲存其預設選項之登錄子機碼字串的 位址。 此子機碼會位在機碼底下 HKEY_CURRENT_USER 。 使用 CoTaskMemAlloc配置此記憶體。 呼叫的應用程式負責使用 CoTaskMemFree釋放此記憶體。 即使方法失敗，這個參數也應該一律初始化為 NULL。

dwReserved
保留供未來使用。 目前未使用。

傳回值

S_OK 如果成功，則 S_FALSE 為 ，否則為 。 如果 S_FALSE為 ，Internet Explorer 或 MSHTML 會預設為自己的用戶選項。

備註

覆寫 OnGetOptionKeyPath 以回應 GetOptionKeyPath 來自 Microsoft 網頁瀏覽器控件的通知。 如需詳細資訊，請參閱 IDocHostUIHandler::GetOptionKeyPath Windows SDK。

CHtmlView::OnHideUI

當 Internet Explorer 或 MSHTML 移除其功能表和工具列時，架構會呼叫此成員函式。

virtual HRESULT OnHideUI();

傳回值

S_OK 如果成功，則為 ，否則為 OLE 定義的錯誤碼。

備註

覆寫 OnHideUI 以回應 HideUI 來自 Microsoft 網頁瀏覽器控件的通知。 如需詳細資訊，請參閱 IDocHostUIHandler::HideUI Windows SDK。

CHtmlView::OnMenuBar

當 屬性變更時 MenuBar ，架構會呼叫這個成員函式。

virtual void OnMenuBar(BOOL bMenuBar);

參數

bMenuBar
如果 Internet Explorer 功能表欄可見，則為非零;否則為零。

CHtmlView::OnNavigateComplete2

巡覽至超連結完成之後，架構會呼叫此成員函式（在視窗或框架集元素上）。

virtual void OnNavigateComplete2(LPCTSTR strURL);

參數

strURL
評估為 URL、UNC 檔名或 PIDL 的字串表示式，也就是巡覽至的專案識別碼清單指標。

備註

如果殼層名稱空間實體沒有 URL 表示法，則 URL 參數可以是 PIDL。

中包含的 strURL URL 與瀏覽器被告知要流覽至的 URL 不同，因為此 URL 是正式化且合格的 URL。 例如，如果應用程式在呼叫 Navigate 或 中指定的"www.microsoft.com"網址，則所OnNavigateComplete2傳遞的網址會是 "<https://www.microsoft.com/>"Navigate2。 此外，如果伺服器已將瀏覽器重新導向至不同的 URL，則會在這裡反映重新導向的 URL。

CHtmlView::OnNavigateError

巡覽至超連結失敗時，由架構呼叫。

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

參數

lpszURL
導覽失敗的 URL。

lpszFrame
要顯示資源之框架的名稱，如果 NULL 資源沒有以具名框架為目標，則為 。

dwError
如果有的話，錯誤狀態代碼。 如需可能 HRESULT 和 HTTP 狀態代碼的清單，請參閱 NavigateError 事件狀態代碼。。

pbCancel
指定取消巡覽至錯誤頁面或任何進一步的自動搜尋。 如果 TRUE 為 （預設值），請繼續瀏覽至錯誤頁面或自動搜尋;如果 FALSE為 ，請取消瀏覽至錯誤頁面或自動搜尋。

備註

覆寫此方法以提供自定義導覽錯誤處理。

如需詳細資訊，請參閱 DWebBrowserEvents2::NavigateError

CHtmlView::OnNewWindow2

建立新視窗以顯示資源時，架構會呼叫此成員函式。

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

參數

ppDisp
介面指標的指標，選擇性地接收 IDispatch 新WebBrowser或Internet Explorer物件的介面指標。

Cancel
取消旗標的指標。 應用程式可以將此參數設定為非零，以取消瀏覽作業，或設定為零以允許它繼續。

備註

此事件會在從 WebBrowser 內建立新視窗之前。

CHtmlView::OnProgressChange

架構會呼叫此成員函式，以通知應用程式下載作業的進度已更新。

virtual void OnProgressChange(
    long nProgress,
    long nProgressMax);

參數

nProgress
要顯示的總進度量，或在進度完成時為 -1。

nProgressMax
進度值上限。

備註

容器可以使用此事件提供的資訊來顯示到目前為止下載的位元組數目，或更新進度指示器。

CHtmlView::OnPropertyChange

架構會呼叫此成員函式，以通知已變更屬性值的應用程式 PutProperty 。

virtual void OnPropertyChange(LPCTSTR lpszProperty);

參數

lpszProperty
包含屬性名稱之字串的指標。

CHtmlView::OnQuit

架構會呼叫此成員函式，以通知應用程式 Internet Explorer 應用程式已準備好結束。

virtual void OnQuit();

CHtmlView::OnResizeBorder

從的 IOleInPlaceActiveObject::ResizeBorderInternet Explorer 或 MSHTML 實作呼叫，它會警示物件需要調整其框線空間的大小。

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

參數

prcBorder
框線空間的新外部矩形。

pUIWindow
框線已變更之框架或文檔視窗物件的介面指標。

fFrameWindow
TRUE 如果框架視窗正在呼叫 ，則為 IOleInPlaceActiveObject::ResizeBorder，否則 FALSE為 。

傳回值

S_OK 如果成功，則為 ，否則為 OLE 定義的錯誤碼。

備註

覆寫 OnResizeBorder 以回應 ResizeBorder 來自 Microsoft 網頁瀏覽器控件的通知。 如需詳細資訊，請參閱 IDocHostUIHandler::ResizeBorder Windows SDK。

CHtmlView::OnShowContextMenu

即將顯示其操作功能表時，從 Internet Explorer 或 MSHTML 呼叫。

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

參數

dwID
要顯示之操作功能表的識別碼。 如需值清單，請參閱 IDocHostUIHandler::ShowContextMenu Windows SDK 中的 。

ppt
功能表的螢幕座標。

pcmdtReserved
IOleCommandTarget 介面，用來查詢命令狀態，並在這個物件上執行命令。

pdispReserved
IDispatch 螢幕座標上物件的介面。 這可讓主機區分特定物件，以提供更特定的內容。

傳回值

如需值清單，請參閱 IDocHostUIHandler::ShowContextMenu Windows SDK 中的 。

備註

覆寫 OnShowContextMenu 以回應 ShowContextMenu 來自 Microsoft 網頁瀏覽器控件的通知。 如需詳細資訊，請參閱 IDocHostUIHandler::ShowContextMenu Windows SDK。

CHtmlView::OnShowUI

在 Internet Explorer 或 MSHTML 顯示其功能表與工具列之前呼叫。

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

參數

dwID
保留供未來使用。

pActiveObject
IOleInPlaceActiveObject 目前使用中物件的介面。

pCommandTarget
IOleCommandTarget 物件的介面。

pFrame
IOleInPlaceFrame 物件的介面。 這需要功能表和工具列。

pDoc
IOleInPlaceUIWindow 物件的介面。 工具列需要此專案。

傳回值

如需值清單，請參閱 IDocHostUIHandler::ShowUI Windows SDK 中的 。

備註

覆寫 OnShowUI 以回應 ShowUI 來自 Microsoft 網頁瀏覽器控件的通知。 如需詳細資訊，請參閱 IDocHostUIHandler::ShowUI Windows SDK。

CHtmlView::OnStatusBar

當 屬性變更時 StatusBar ，架構會呼叫這個成員函式。

virtual void OnStatusBar(BOOL bStatusBar);

參數

bStatusBar
如果 Internet Explorer 的狀態列為可見或零，則為非零。

CHtmlView::OnStatusTextChange

架構會呼叫此成員函式，通知應用程式與 WebBrowser 控件相關聯的狀態列文字已變更。

virtual void OnStatusTextChange(LPCTSTR lpszText);

參數

lpszText
包含新狀態列文字的字串。

CHtmlView::OnTheaterMode

當 屬性變更時 TheaterMode ，架構會呼叫這個成員函式。

virtual void OnTheaterMode(BOOL bTheaterMode);

參數

bTheaterMode
如果 Internet Explorer 處於劇院模式，則為非零;否則為零。

CHtmlView::OnTitleChange

架構會呼叫此成員函式，以在 WebBrowser 控件中的文件標題變成可用或變更時通知應用程式。

virtual void OnTitleChange(LPCTSTR lpszText);

參數

lpszText
新的文件標題。

備註

若為 HTML，標題可能會變更;當 HTML 仍在下載時，檔的 URL 會設定為標題。 從 HTML 剖析實際標題之後（如果有的話），標題會變更以反映實際的標題。

CHtmlView::OnToolBar

當 屬性變更時 ToolBar ，架構會呼叫這個成員函式。

virtual void OnToolBar(BOOL bToolBar);

參數

bToolBar
如果 Internet Explorer 的工具列為可見或零，則為非零。

CHtmlView::OnTranslateAccelerator

呼叫 Internet Explorer 或 MSHTML，以處理來自容器消息佇列的功能表快捷鍵訊息時IOleInPlaceActiveObject::TranslateAcceleratorIOleControlSite::TranslateAccelerator或 MSHTML 呼叫。

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

參數

lpMsg
指向可能需要翻譯的訊息。

pguidCmdGroup
命令群組標識碼。

nCmdID
命令標識碼。

傳回值

S_OK 如果成功，則 S_FALSE 為 ，否則為 。

備註

覆寫 OnTranslateAccelerator 以回應 TranslateAccelerator 來自 Microsoft 網頁瀏覽器控件的通知。 如需詳細資訊，請參閱 IDocHostUIHandler::TranslateAccelerator Windows SDK。

CHtmlView::OnTranslateUrl

由 Internet Explorer 或 MSHTML 呼叫，讓主機有機會修改要載入的 URL。

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

參數

dwTranslate
保留供未來使用。

pchURLIn
Internet Explorer 或 MSHTML 所提供的字串位址，代表要翻譯的 URL。

ppchURLOut
接收已翻譯URL位址的字串指標位址。 主機會使用工作記憶體配置器來配置緩衝區。 即使 URL 未轉譯或方法失敗，此參數的內容也應該一律初始化為 NULL。

傳回值

S_OK 如果 URL 已轉譯、 S_FALSE URL 未轉譯，或發生錯誤則為 OLE 定義的錯誤碼。

備註

覆寫 OnTranslateUrl 以回應 TranslateUrl 來自 Microsoft 網頁瀏覽器控件的通知。 如需詳細資訊，請參閱 IDocHostUIHandler::TranslateUrl Windows SDK。

CHtmlView::OnUpdateUI

通知主機命令狀態已變更。

virtual HRESULT OnUpdateUI();

傳回值

S_OK 如果成功，則為 ，否則為 OLE 定義的錯誤碼。

備註

主機應該更新工具列按鈕的狀態。 不論 來自 ShowUI的傳回值為何，都會呼叫這個方法。 覆寫 OnUpdateUI 以回應 UpdateUI 來自 Microsoft 網頁瀏覽器控件的通知。

CHtmlView::OnVisible

當 WebBrowser 的視窗應該顯示或隱藏時，架構會呼叫此成員函式。

virtual void OnVisible(BOOL bVisible);

參數

bVisible
如果對象為可見或零，則為非零。

備註

這可讓物件控件主窗口的行為與 Internet Explorer 視窗的行為相同。

CHtmlView::PutProperty

呼叫這個成員函式，以設定與指定對象相關聯的屬性。

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);

參數

lpszProperty
字串，包含要設定的屬性。

vtValue
所指示 lpszProperty之 屬性的新值。

lpszPropertyName
字串的指標，其中包含要設定的屬性名稱。

dValue
屬性的新值。

lValue
屬性的新值。

lpszValue
字串的指標，其中包含 屬性的新值。

nValue
屬性的新值。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::QueryFormsCommand

查詢使用者介面事件所產生之一或多個命令的狀態。

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

參數

dwCommandID
要查詢之命令的識別碼。

pbSupported
的指標 BOOL ，指定是否支援 命令（由 dwCommandID識別）。 如果 TRUE為 ，則支援 命令，否則 FALSE為 。

pbEnabled
的指標 BOOL ，指定是否啟用 命令（由 dwCommandID識別）。 如果 TRUE為 ，則支援 命令，否則 FALSE為 。

pbChecked
的指標 BOOL ，指定是否已檢查 命令（由 dwCommandID識別）。 如果 TRUE為 ，則支援 命令，否則 FALSE為 。

傳回值

標準 HRESULT 值。 如需可能值的完整清單，請參閱 IOleCommandTarget::QueryStatus Windows SDK。

備註

QueryFormsCommand 會實作 方法的行為 IOleCommandTarget::QueryStatus 。

CHtmlView::QueryStatusWB

呼叫此成員函式以查詢命令狀態。

OLECMDF QueryStatusWB(OLECMDID cmdID) const;

參數

cmdID
OLECMDID呼叫端需要狀態資訊的命令值。

傳回值

接收命令狀態之值的位址 OLECMDF 。

備註

QueryStatusWB 會實作 方法的行為 IOleCommandTarget::QueryStatus 。

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::Refresh

重載網頁瀏覽器目前顯示的 URL 或檔案。

void Refresh();

備註

Refresh 未包含設定重新整理層級的參數。

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::Refresh2

重載 Internet Explorer 目前顯示的檔案。

void Refresh2(int nLevel);

參數

nLevel
指定重新整理層級之變數的位址。 可能的變數定義於 RefreshConstantsWindows SDK 中的 。

備註

不同於 Refresh， Refresh2 包含指定重新整理層級的參數。

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::SetAddressBar

呼叫此成員函式以顯示或隱藏 Internet Explorer 物件的網址列。

void SetAddressBar(BOOL bNewValue);

參數

bNewValue
非零顯示網址列;否則為零。

備註

適用於 Internet Explorer。 如果您使用此呼叫搭配 WebBrowser 控件，則不會傳回錯誤，但會忽略此呼叫。

CHtmlView::SetFullScreen

呼叫此成員函式，將 Internet Explorer 設定為全螢幕或一般視窗模式。

void SetFullScreen(BOOL bNewValue);

參數

bNewValue
全螢幕模式的非零;否則為零。

備註

在全螢幕模式中，Internet Explorer 主視窗會最大化，並隱藏狀態列、工具列、功能表欄和標題列。

適用於 Internet Explorer。 如果您使用此呼叫搭配 WebBrowser 控件，則不會傳回錯誤，但會忽略此呼叫。

CHtmlView::SetHeight

呼叫此成員函式以設定 Internet Explorer 主視窗的高度。

void SetHeight(long nNewValue);

參數

nNewValue
主視窗的高度，以像素為單位。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::SetLeft

設定 Internet Explorer 主視窗的水平位置。

void SetLeft(long nNewValue);

參數

nNewValue
主視窗左邊緣的螢幕座標。

CHtmlView::SetMenuBar

呼叫此成員函式以顯示或隱藏 Internet Explorer 功能表欄。

void SetMenuBar(BOOL bNewValue);

參數

bNewValue
非零顯示功能表欄;否則為零。

備註

適用於 Internet Explorer。 如果您使用此呼叫搭配 WebBrowser 控件，則不會傳回錯誤，但會忽略此呼叫。

CHtmlView::SetOffline

呼叫這個成員函式來設定值，指出WebBrowser控件目前是否處於離線模式。

void SetOffline(BOOL bNewValue);

參數

bNewValue
從本機快取讀取的非零;否則為零。

備註

在離線模式中，瀏覽器會從本機快取讀取 HTML 頁面，而不是從源文檔讀取。

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::SetRegisterAsBrowser

呼叫這個成員函式來設定值，指出WebBrowser控件是否註冊為目標名稱解析的最上層瀏覽器。

void SetRegisterAsBrowser(BOOL bNewValue);

參數

bNewValue
判斷 Internet Explorer 是否註冊為最上層瀏覽器。 如果不是零，網頁瀏覽器會註冊為最上層瀏覽器;如果為零，則不是最上層瀏覽器。 預設值為零。

備註

最上層瀏覽器是在登錄中設定為預設瀏覽器的瀏覽器。

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::SetRegisterAsDropTarget

呼叫這個成員函式來設定值，指出 WebBrowser 控件是否註冊為流覽的置放目標。

void SetRegisterAsDropTarget(BOOL bNewValue);

參數

bNewValue
判斷 WebBrowser 控制項是否已註冊為流覽的置放目標。 如果為非零，則會將對象註冊為置放目標;如果為零，則不是置放目標。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::SetSilent

呼叫這個成員函式來設定值，指出是否可以顯示任何對話框。

void SetSilent(BOOL bNewValue);

參數

bNewValue
如果非零，將不會顯示對話框;如果為零，則會顯示對話方塊。 預設值為零。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::SetStatusBar

呼叫此成員函式以顯示狀態列。

void SetStatusBar(BOOL bNewValue);

參數

bNewValue
如果狀態列為可見，則為非零;否則為零。

備註

適用於 Internet Explorer。 如果您使用此呼叫搭配 WebBrowser 控件，則不會傳回錯誤，但會忽略此呼叫。

CHtmlView::SetTheaterMode

呼叫這個成員函式來設定值，指出WebBrowser控件是否處於劇院模式。

void SetTheaterMode(BOOL bNewValue);

參數

bNewValue
非零將WebBrowser控件設定為劇院模式;否則為零。 預設值為零。

備註

當網頁瀏覽器處於劇院模式時，瀏覽器主視窗會填滿整個畫面、一組最少導覽工具的工具列隨即出現，而狀態列會出現在畫面右上角。

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::SetToolBar

呼叫此成員函式以顯示或隱藏 Internet Explorer 工具列。

void SetToolBar(int nNewValue);

參數

nNewValue
指出是否要顯示工具列。 如果要顯示工具列，則為非零;否則為零。

備註

適用於 Internet Explorer。 如果您使用此呼叫搭配 WebBrowser 控件，則不會傳回錯誤，但會忽略此呼叫。

CHtmlView::SetTop

呼叫這個成員函式，以設定 WebBrowser 控件內部上邊緣與其容器上邊緣之間的距離

void SetTop(long nNewValue);

參數

nNewValue
主視窗上邊緣的螢幕座標。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::SetVisible

呼叫這個成員函式，以設定 WebBrowser 控件的可見性狀態。

void SetVisible(BOOL bNewValue);

參數

bNewValue
如果控件為可見，則為非零;否則為零。

備註

適用於 Internet Explorer 和 WebBrowser。

CHtmlView::SetWidth

設定 Internet Explorer 主視窗的寬度。

void SetWidth(long nNewValue);

參數

nNewValue
Internet Explorer 主視窗的寬度，以像素為單位。

CHtmlView::Stop

呼叫此成員函式以取消任何暫止的瀏覽或下載作業，並停止任何動態頁面元素，例如背景音效和動畫。

void Stop();

備註

適用於 Internet Explorer 和 WebBrowser。

另請參閱

MFC 範例 MFCIE
CFormView 類別
階層圖
IWebBrowser2