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::OnDocWindowActivate Internet 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::ResizeBorder Internet 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 控制項上成功，但不會有任何明顯的效果。

繼承階層架構

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。

呼叫此成員函式以流覽至 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。

呼叫此成員函式以巡覽至 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" URL，則 所 OnNavigateComplete2 傳遞的 URL 會是 "<https://www.microsoft.com/>"Navigate2 。 此外，如果伺服器已將瀏覽器重新導向至不同的 URL，則會在這裡反映重新導向的 URL。

CHtmlView::OnDocWindowActivate

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

virtual HRESULT OnDocWindowActivate(BOOL fActivate);

參數

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

傳回值

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

備註

覆寫 OnDocWindowActivate 以回應 OnDocWindowActivate Microsoft Web Browser 控制項的通知。 如需詳細資訊，請參閱 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 Web Browser 控制項的通知。 如需詳細資訊，請參閱 IDocHostUIHandler::EnableModeless Windows SDK。

CHtmlView::OnFilterDataObject

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

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

參數

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

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

傳回值

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

備註

覆寫 OnFilterDataObject 以回應 FilterDataObject Microsoft Web Browser 控制項的通知。 如需詳細資訊，請參閱 IDocHostUIHandler::FilterDataObject Windows SDK。

CHtmlView::OnFrameWindowActivate

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

virtual HRESULT OnFrameWindowActivate(BOOL fActivate);

參數

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

傳回值

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

備註

覆寫 OnFrameWindowActivate 以回應 OnFrameWindowActivate Microsoft Web Browser 控制項的通知。 如需詳細資訊，請參閱 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 Web Browser 控制項的通知。 如需詳細資訊，請參閱 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 Web Browser 控制項的通知。 如需詳細資訊，請參閱 IDocHostUIHandler::GetExternal Windows SDK。

CHtmlView::OnGetHostInfo

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

virtual HRESULT OnGetHostInfo(DOCHOSTUIINFO* pInfo);

參數

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

傳回值

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

備註

覆寫 OnGetHostInfo 以回應 GetHostInfo Microsoft Web Browser 控制項的通知。 如需詳細資訊，請參閱 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 Web Browser 控制項的通知。 如需詳細資訊，請參閱 IDocHostUIHandler::GetOptionKeyPath Windows SDK。

CHtmlView::OnHideUI

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

virtual HRESULT OnHideUI();

傳回值

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

備註

覆寫 OnHideUI 以回應 HideUI Microsoft Web Browser 控制項的通知。 如需詳細資訊，請參閱 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" URL，則 所 OnNavigateComplete2 傳遞的 URL 會是 "<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::ResizeBorder Internet Explorer 或 MSHTML 實作呼叫，它會警示物件需要調整其框線空間的大小。

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

參數

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

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

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

傳回值

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

備註

覆寫 OnResizeBorder 以回應 ResizeBorder Microsoft Web Browser 控制項的通知。 如需詳細資訊，請參閱 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 Web Browser 控制項的通知。 如需詳細資訊，請參閱 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 Web Browser 控制項的通知。 如需詳細資訊，請參閱 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 Web Browser 控制項的通知。 如需詳細資訊，請參閱 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 Web Browser 控制項的通知。 如需詳細資訊，請參閱 IDocHostUIHandler::TranslateUrl Windows SDK。

CHtmlView::OnUpdateUI

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

virtual HRESULT OnUpdateUI();

傳回值

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

備註

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

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
指定重新整理層級之變數的位址。 可能的變數定義于 RefreshConstants Windows 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