CHtmlView 类

提供 MFC 文档/视图体系结构上下文中的 Web 浏览器控件功能。

语法

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	检索 web 浏览器中显示的资源的完整名称，包括路径。 （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	检索 web 浏览器对象的就绪状态。
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	调用以通知应用程序 Web 浏览器命令的启用状态已更改。
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 调用以允许主机提供替代的 IDropTarget。
CHtmlView::OnGetExternal	由 Internet Explorer 或 MSHTML 调用以获取主机的 IDispatch 接口。
CHtmlView::OnGetHostInfo	检索 Internet Explorer 或 MSHTML 主机的用户界面功能。
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	调用 IOleInPlaceActiveObject::TranslateAccelerator 或 IOleControlSite::TranslateAccelerator 以处理来自容器消息队列的菜单加速键消息时，由 Internet Explorer 或 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 控件是在全屏模式下还是在正常窗口模式下运行。 （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) 导航，并维护历史记录列表。

在 MFC 应用程序中使用 CHtmlView 类

在标准 MFC 框架应用程序（基于 SDI 或 MDI）中，视图对象通常派生自专用的一组类。 这些类全部派生自 CView，它们提供 CView所没有提供的专用功能。

将 CHtmlView 作为应用程序的视图类的基础可向视图提供 WebBrowser 控件。 这将有效地使应用程序成为一个 Web 浏览器。 创建一个 Web 浏览器样式的应用程序的首选方法是使用 MFC 应用程序向导，并将 CHtmlView 指定为视图类。 有关在 MFC 应用程序内实现和使用 WebBrowser 控件的详细信息，请参阅 创建 Web 浏览器样式的应用程序。

注意

WebBrowser ActiveX 控件（因此 CHtmlView）仅可用于在 Windows NT 4.0 版或更高版本（其中安装了 Internet Explorer 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
视图的 ID 号。 默认设置为 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 值。 有关可能值的完整列表，请参阅 Windows SDK 中的 IOleCommandTarget::Exec。

备注

ExecFormsCommand 实现 IOleCommandTarget::Exec 方法的行为。

CHtmlView::ExecWB

调用此成员函数以在 WebBrowser 或 Internet Explorer 中执行命令。

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

参数

cmdID
要执行的命令。

cmdexecopt
用于执行命令的选项。

pvaIn
用于指定命令输入参数的变体。

pvaOut
用于指定命令输出参数的变体。

备注

请参阅 Windows SDK 中的IWebBrowser2::ExecWB。

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;

返回值

如果 Web 浏览器繁忙，则为非零值；否则为零。

备注

适用于 Internet Explorer 和 WebBrowser。

CHtmlView::GetContainer

调用此成员函数以检索计算结果为 Web 浏览器容器的对象。

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 页面，则名称为该页的标题。 如果资源是网络或本地计算机上的文件夹或文件，则名称是该文件夹或文件的完整路径。

适用于 Internet Explorer 和 WebBrowser。

CHtmlView::GetLocationURL

调用此成员函数以检索 WebBrowser 控件当前显示的资源的 URL。

CString GetLocationURL() const;

返回值

一个 CString 对象，其中包含当前显示在 WebBrowser 中的资源的 URL。

备注

如果资源是网络或本地计算机上的文件夹或文件，则名称是该文件夹或文件的完整路径。

适用于 Internet Explorer 和 WebBrowser。

CHtmlView::GetMenuBar

调用此成员函数以确定菜单栏是否可见。

BOOL GetMenuBar() const;

返回值

如果菜单栏可见，则为非零值；否则为零。

备注

适用于 Internet Explorer 和 WebBrowser。

CHtmlView::GetOffline

调用此成员函数以确定 Web 浏览器是否脱机运行。

BOOL GetOffline() const;

返回值

如果 Web 浏览器当前处于脱机状态，则为非零值；否则为零。

备注

适用于 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);

返回值

如果成功，则不为零，否则为零。

参数

refString
将保存源代码的 CString。

备注

此函数等效于 Internet Explorer 中的“查看源”命令，只是源代码是在一个 CString 中返回的。

CHtmlView::GetStatusBar

调用此成员函数以确定 WebBrowser 控件是否显示状态栏。

BOOL GetStatusBar() const;

返回值

如果显示状态栏，则为非零值；否则为零。

备注

适用于 Internet Explorer。 如果将此调用与 WebBrowser 控件一起使用，则不会返回错误，但将忽略此调用。

CHtmlView::GetTheaterMode

调用此成员函数以确定 Web 浏览器是否处于剧院模式。

BOOL GetTheaterMode() const;

返回值

如果 Web 浏览器处于剧院模式，则为非零值；否则为零。

备注

当 Web 浏览器处于剧院模式时，浏览器主窗口会填满整个屏幕，会出现一个带有最少导航工具集的工具栏，并且状态栏会出现在屏幕的右上角。

适用于 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 Internet 选项”对话框或“Internet 属性”对话框（可从“控制面板”访问）中指定的网页。

void GoHome();

备注

适用于 Internet Explorer 和 WebBrowser。

CHtmlView::GoSearch

导航到当前搜索页面，如“Internet Explorer Internet 选项”对话框或“Internet 属性”对话框（可从“控制面板”访问）中所述。

void GoSearch();

备注

适用于 Internet Explorer 和 WebBrowser。

CHtmlView::LoadFromResource

调用此成员函数以将指定的资源加载到 WebBrowser 控件中。

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

参数

lpszResource
指向包含要加载的资源名称的字符串的指针。

nRes
包含要加载的资源名称的缓冲区的 ID。

返回值

如果成功，则不为零，否则为零。

注解

适用于 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 表示的特殊文件夹（例如 Desktop 和 My Computer）。

适用于 Internet Explorer 和 WebBrowser。

示例

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

CHtmlView::OnBeforeNavigate2

此成员函数由框架调用，以在 Web 浏览器中执行导航操作之前引发要触发的事件。

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

参数

lpszURL
指向包含要导航到的 URL 的字符串的指针。

nFlags
保留供将来使用。

lpszTargetFrameName
一个字符串，其中包含要在其中显示资源的框架的名称，如果没有指定框架作为资源的目标，则为 NULL。

baPostedData
如果使用 HTTP POST 事务，则为对 CByteArray 对象的引用，该对象包含要发送到服务器的数据。

lpszHeaders
指向字符串的指针，该字符串包含要发送到服务器的其他 HTTP 标头（仅限 HTTP URL）。 标头可以指定以下内容，例如服务器所需的操作、要传递给服务器的数据类型或状态代码。

pbCancel
指向取消标志的指针。 应用程序可以将此参数设置为非零值，以取消导航操作，或设置为零以继续。

CHtmlView::OnCommandStateChange

此成员函数由框架调用，以通知应用程序 Web 浏览器命令的启用状态已更改。

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 或 Navigate2 的调用中指定 URL 为 "www.microsoft.com"，则 OnNavigateComplete2 传递的 URL 将为 "<https://www.microsoft.com/>"。 此外，如果服务器已将浏览器重定向到不同的 URL，则会在此处反映重定向的 URL。

CHtmlView::OnDocWindowActivate

从 IOleInPlaceActiveObject::OnDocWindowActivate 的 Internet Explorer 或 MSHTML 实现调用，该操作将在激活或停用容器文件窗口时通知活动的就地对象。

virtual HRESULT OnDocWindowActivate(BOOL fActivate);

参数

fActivate
指示文档窗口的状态。 如果此值为非零值，则会激活窗口。 如果此值为零，则会取消激活窗口。

返回值

如果成功，则为 S_OK；否则为 OLE 定义的错误代码。

备注

替代 OnDocWindowActivate 以响应来自 Microsoft Web 浏览器控件的 OnDocWindowActivate 通知。 有关详细信息，请参阅 Windows SDK 中的 IDocHostUIHandler::OnDocWindowActivate。

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 以响应来自 Microsoft Web 浏览器控件的 EnableModeless 通知。 有关详细信息，请参阅 Windows SDK 中的 IDocHostUIHandler::EnableModeless。

CHtmlView::OnFilterDataObject

由 Internet Explorer 或 MSHTML 对主机调用，以允许主机替换 Internet Explorer 或 MSHTML 的数据对象。

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

参数

pDataObject
Internet Explorer 或 MSHTML 提供的 IDataObject 接口的地址。

ppDataObject
接收主机提供的 IDataObject 接口指针的地址。 此参数的内容应始终初始化为 NULL，即使方法失败也应如此。

返回值

如果数据对象被替换，则为 S_OK，如果数据对象没有被替换，则为 S_FALSE，或者如果发生错误，则为 OLE 定义的错误代码。

注解

替代 OnFilterDataObject 以响应来自 Microsoft Web 浏览器控件的 FilterDataObject 通知。 有关详细信息，请参阅 Windows SDK 中的 IDocHostUIHandler::FilterDataObject。

CHtmlView::OnFrameWindowActivate

从 IOleInPlaceActiveObject::OnFrameWindowActivate 调用，以便在激活或停用容器的顶级框架窗口时通知该对象。

virtual HRESULT OnFrameWindowActivate(BOOL fActivate);

参数

fActivate
指示容器的顶级框架窗口的状态。 如果此值为非零值，则会激活窗口。 如果此值为零，则会取消激活窗口。

返回值

如果成功，则为 S_OK；否则为 OLE 定义的错误代码。

备注

替代 OnFrameWindowActivate 以响应来自 Microsoft Web 浏览器控件的 OnFrameWindowActivate 通知。 有关详细信息，请参阅 Windows SDK 中的 IDocHostUIHandler::OnFrameWindowActivate。

CHtmlView::OnFullScreen

此成员函数在 FullScreen 属性发生更改时由框架调用。

virtual void OnFullScreen(BOOL bFullScreen);

参数

bFullScreen
如果 Internet Explorer 处于全屏模式，则为非零值；否则为零。

CHtmlView::OnGetDropTarget

当用作放置目标时由 Internet Explorer 或 MSHTML 调用以允许主机提供替代的 IDropTarget。

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

参数

pDropTarget
IDropTarget Internet Explorer 或 MSHTML 建议使用。

ppDropTarget
接收主机要提供的 IDropTarget 接口指针的 IDropTarget 的地址。

返回值

有关返回代码列表，请参阅 Windows SDK 中的 IDocHostUIHandler::GetDropTarget。

备注

替代 OnGetDropTarget 以响应来自 Microsoft Web 浏览器控件的 GetDropTarget 通知。 有关详细信息，请参阅 Windows SDK 中的 IDocHostUIHandler::GetDropTarget。

CHtmlView::OnGetExternal

由 Internet Explorer 或 MSHTML 调用以获取主机的 IDispatch 接口。

virtual HRESULT OnGetExternal(LPDISPATCH* lppDispatch);

参数

lppDispatch
指向地址的指针，该地址用于接收主机应用程序的 IDispatch 接口指针。 如果主机公开自动化接口，则可以通过此参数提供对 Internet Explorer 或 MSHTML 的引用。 此参数的内容应始终初始化为 NULL，即使方法失败也应如此。

返回值

如果成功，则为 S_OK；否则为 OLE 定义的错误代码。

备注

替代 OnGetExternal 以响应来自 Microsoft Web 浏览器控件的 GetExternal 通知。 有关详细信息，请参阅 Windows SDK 中的 IDocHostUIHandler::GetExternal。

CHtmlView::OnGetHostInfo

检索 Internet Explorer 或 MSHTML 主机的用户界面功能。

virtual HRESULT OnGetHostInfo(DOCHOSTUIINFO* pInfo);

参数

pInfo
接收主机 UI 功能的 DOCHOSTUIINFO 结构的地址。

返回值

如果成功，则为 S_OK；否则为 OLE 定义的错误代码。

备注

替代 OnGetHostInfo 以响应来自 Microsoft Web 浏览器控件的 GetHostInfo 通知。 有关详细信息，请参阅 Windows SDK 中的 IDocHostUIHandler::GetHostInfo。

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 以响应来自 Microsoft Web 浏览器控件的 GetOptionKeyPath 通知。 有关详细信息，请参阅 Windows SDK 中的 IDocHostUIHandler::GetOptionKeyPath。

CHtmlView::OnHideUI

此成员函数在 Internet Explorer 或 MSHTML 删除其菜单和工具栏时由框架调用。

virtual HRESULT OnHideUI();

返回值

如果成功，则为 S_OK；否则为 OLE 定义的错误代码。

备注

替代 OnHideUI 以响应来自 Microsoft Web 浏览器控件的 HideUI 通知。 有关详细信息，请参阅 Windows SDK 中的 IDocHostUIHandler::HideUI。

CHtmlView::OnMenuBar

此成员函数在 MenuBar 属性发生更改时由框架调用。

virtual void OnMenuBar(BOOL bMenuBar);

参数

bMenuBar
如果 Internet Explorer 菜单栏可见，则为非零值；否则为零。

CHtmlView::OnNavigateComplete2

此成员函数在导航到超链接后由框架调用（在窗口或框架集元素上）。

virtual void OnNavigateComplete2(LPCTSTR strURL);

参数

strURL
字符串表达式，其计算结果为导航到的 URL、UNC 文件名或 PIDL（指向项标识符列表的指针）。

备注

如果存在没有 URL 表示的 shell 名称空间实体，则 URL 参数可以是 PIDL。

strURL 中包含的 URL 可能与告知浏览器导航到的 URL 不同，因为该 URL 是规范化和限定的 URL。 例如，如果应用程序在对 Navigate 或 Navigate2 的调用中指定 URL 为 "www.microsoft.com"，则 OnNavigateComplete2 传递的 URL 将为 "<https://www.microsoft.com/>"。 此外，如果服务器已将浏览器重定向到不同的 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
指向接口指针的指针，可选择接收新 WebBrowser 或 Internet Explorer 对象的 IDispatch 接口指针。

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
如果框架窗口正在调用 IOleInPlaceActiveObject::ResizeBorder，则为 TRUE；否则为 FALSE。

返回值

如果成功，则为 S_OK；否则为 OLE 定义的错误代码。

备注

替代 OnResizeBorder 以响应来自 Microsoft Web 浏览器控件的 ResizeBorder 通知。 有关详细信息，请参阅 Windows SDK 中的 IDocHostUIHandler::ResizeBorder。

CHtmlView::OnShowContextMenu

当 Internet Explorer 或 MSHTML 将要显示其上下文菜单时，从其调用。

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

参数

dwID
要显示的上下文菜单的标识符。 有关值列表，请参阅 Windows SDK 中的 IDocHostUIHandler::ShowContextMenu。

ppt
菜单的屏幕坐标。

pcmdtReserved
用于查询命令状态和对该对象执行命令的 IOleCommandTarget 接口。

pdispReserved
屏幕坐标处对象的 IDispatch 接口。 这样，主机就可以区分特定对象以提供更具体的上下文。

返回值

有关值列表，请参阅 Windows SDK 中的 IDocHostUIHandler::ShowContextMenu。

备注

替代 OnShowContextMenu 以响应来自 Microsoft Web 浏览器控件的 ShowContextMenu 通知。 有关详细信息，请参阅 Windows SDK 中的 IDocHostUIHandler::ShowContextMenu。

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 接口。 工具栏需要此接口。

返回值

有关值列表，请参阅 Windows SDK 中的 IDocHostUIHandler::ShowUI。

备注

替代 OnShowUI 以响应来自 Microsoft Web 浏览器控件的 ShowUI 通知。 有关详细信息，请参阅 Windows SDK 中的 IDocHostUIHandler::ShowUI。

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

调用 IOleInPlaceActiveObject::TranslateAccelerator 或 IOleControlSite::TranslateAccelerator 以处理来自容器消息队列的菜单加速键消息时，由 Internet Explorer 或 MSHTML 调用。

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

参数

lpMsg
指向可能需要翻译的消息。

pguidCmdGroup
命令组标识符。

nCmdID
命令标识符。

返回值

如果成功，则为 S_OK，否则为 S_FALSE。

备注

替代 OnTranslateAccelerator 以响应来自 Microsoft Web 浏览器控件的 TranslateAccelerator 通知。 有关详细信息，请参阅 Windows SDK 中的 IDocHostUIHandler::TranslateAccelerator。

CHtmlView::OnTranslateUrl

由 Internet Explorer 或 MSHTML 调用以允许主机有机会修改要加载的 URL。

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

参数

dwTranslate
保留供将来使用。

pchURLIn
Internet Explorer 或 MSHTML 提供的字符串的地址，表示要翻译的 URL。

ppchURLOut
接收已翻译 URL 地址的字符串指针的地址。 主机使用任务内存分配器分配缓冲区。 此参数的内容应始终初始化为 NULL，即使未翻译 URL 或即使方法失败也应如此。

返回值

如果已翻译 URL，则为 S_OK，如果未翻译 URL，则为 S_FALSE，或者如果发生错误，则为 OLE 定义的错误代码。

注解

替代 OnTranslateUrl 以响应来自 Microsoft Web 浏览器控件的 TranslateUrl 通知。 有关详细信息，请参阅 Windows SDK 中的 IDocHostUIHandler::TranslateUrl。

CHtmlView::OnUpdateUI

通知主机命令状态已更改。

virtual HRESULT OnUpdateUI();

返回值

如果成功，则为 S_OK；否则为 OLE 定义的错误代码。

注解

主机应更新工具栏按钮的状态。 无论 ShowUI 的返回值为何，都会调用此方法。 替代 OnUpdateUI 以响应来自 Microsoft Web 浏览器控件的 UpdateUI 通知。

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 值。 有关可能值的完整列表，请参阅 Windows SDK 中的 IOleCommandTarget::QueryStatus。

备注

QueryFormsCommand 实现 IOleCommandTarget::QueryStatus 方法的行为。

CHtmlView::QueryStatusWB

调用此成员函数以查询命令状态。

OLECMDF QueryStatusWB(OLECMDID cmdID) const;

参数

cmdID
调用方需要其状态信息的命令的 OLECMDID 值。

返回值

接收命令状态的 OLECMDF 值的地址。

备注

QueryStatusWB 实现 IOleCommandTarget::QueryStatus 方法的行为。

适用于 Internet Explorer 和 WebBrowser。

CHtmlView::Refresh

重新加载 Web 浏览器当前显示的 URL 或文件。

void Refresh();

注解

Refresh 不包含用于设置刷新级别的参数。

适用于 Internet Explorer 和 WebBrowser。

CHtmlView::Refresh2

重新加载 Internet Explorer 当前显示的文件。

void Refresh2(int nLevel);

参数

nLevel
指定刷新级别的变量的地址。 有关可能的变量，请参阅 Windows SDK 中的 RefreshConstants。

备注

与 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 注册为顶级浏览器。 如果为非零值，则 Web 浏览器将注册为顶级浏览器；如果为零，则不会注册为顶级浏览器。 默认值为零。

注解

顶级浏览器是在注册表中设置为默认浏览器的浏览器。

适用于 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 控件设置为剧院模式，则为非零值；否则为零。 默认值为零。

备注

当 Web 浏览器处于剧院模式时，浏览器主窗口会填满整个屏幕，会出现一个带有最少导航工具集的工具栏，并且状态栏会出现在屏幕的右上角。

适用于 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