IWebBrowserApp
IWebBrowserApp 接口仅仅在IE中实现。 典型的,你使用InternetExplorer 对象创建一个IE的实例. 然后你使用 IWebBrowserApp 接口操纵此实例. (今天采用IWebBrowser2 替代) IWebBrowserApp 接口继承自 IWebBrowser, 所以它提供 IWebBrowser 的全部功能。
因为IWebBrowserApp呈现一个IE窗口的实例, 所以它的方法和属性典型地允许你控制浏览器窗口的用户接口。 这些方法和属性并非包含在WebBrowser的 IWebBrowser 中的:寄宿control的应用程序提供诸如状态条, 工具条, 以及菜单条等用户接口. WebBrowser 控件仅仅用于装载web页以及其它类型文件。
IWebBrowserApp 有4个方法和10 各属性。
方法 IWebBrowserApp 接口的属性很直观立如下表, 但是有2个有理由值的讨论:GetProperty 和 PutProperty. 此两个方法允许你在IE属性包(property bag)中存储一个属性一边你能够在其后重新找回他们。 你将典型地从一个web页上存储一些状态信息到另一个web页 (事实上,使用IWebBrowser2 接口你可以在宿主一个WebBrowser 控件时候使用此方法)
Table 6-3. IWebBrowserApp vtable 次序的方法
方法
|
描述
|
Quit
|
促使 Internet Explorer 窗口关闭。换句话讲,将自动化操作关闭 IE 实例
|
ClientToWindow
|
转换一个点从窗口坐标到客户坐标。
|
PutProperty
|
存储一个属性值到 ie 的属性包,将可以随手采用 GetProperty . 获取
|
GetProperty
|
获取先前由 PutProperty . 方法存储的属性值
|
VB代码:
InternetExplorer1.PutProperty "CurrentPicture", 10
InternetExplorer1.GetProperty("CurrentPicture")
VC++代码:
CSomeClass::PutGetProperty(VARIANT vtCurrentValue, VARIANT* vtNewValue)
{
HRESULT hr;
hr = m_pInternetExplorer->PutProperty(L"CurrentPicture", vtCurrentValue);
if (SUCCEEDED(hr))
{
// Notice that vtNewValue is already a pointer, so you
// don't have to pass the address to GetProperty.
//
hr = m_pInternetExplorer->GetProperty(L"CurrentPicture", vtNewValue);
}
return hr;
}
PutGetProperty 方法接受包含当前属性值的 VARIANT 变量指针且将接收属性值。
属性 IWebBrowserApp 接口有10 个属性. Table 6-4. IWebBrowserApp vtable 次序的属性
属性
|
描述
|
Name
|
返回对象的名称 t. ( 举例,当自动化 IE , Name 属性将返回 Microsoft Internet Explorer .)
|
HWND
|
返回 IE 窗口的句柄
|
FullName
|
返回 ie 可执行文件的全路径 (iexplore.exe).
|
Path
|
返回 IE 应用程序的全路径 .
|
Visible
|
监测和设置 IE 窗口是否可见。 ( 换句话讲,你可与使用此属性显示 / 隐藏 )
|
StatusBar
|
显示或者隐藏 IE 状态条,也可监测当前状态条
|
StatusText
|
设置或隐藏状态条文字
|
ToolBar
|
显示或者隐藏 IE 工具条,也可监测当前工具条状态
|
MenuBar
|
显示或者隐藏 IE 菜单条,也可监测当前工具菜单态
|
FullScreen
|
设置或者检测一个值指示 IE 当前是否最大化显示。最大化显示, iE 占据整个屏幕
|
Table 6-4 中的属性列表直截了当且易于使用。举例来说, 如果你想从你的Vb程序中获取IE状态条中的文字,你应当使用如下代码:
Dim strStatusText
strStatusText = InternetExplorer1.StatusText
使用MFC包装类的VC++程序代码如下:
BSTR bstrStatusText;
HRESULT hr = m_pInternetExplorer->get_StatusText(&bstrStatusText);
IWebBrowser2
因为COM规则要求接口恒久不变, 要加入新的工呢高COM,你必须增加新的接口。 新的接口可扩展自其他接口已扩展功能。 举例,当心的需求引入WebBrowser 和Internet Explorer 接口, 开发者被要求建立一个新的接口: IWebBrowser2.
早期, IWebBrowser2 继承自 IWebBrowser 和 IWebBrowserApp,还提供不包含在着两个接口中的功能. 所以你应当使用IWebBrowser2 接口替代 来操纵WebBrowser 控件或者 Internet Explorer.
IWebBrowser2 接口有4个方法和8个属性.
方法 IWebBrowser2 接口方法如下描述,按照 vtable 次序, in Table 6-5.
也许IWebBrowser2 、接口踵使用最多的方法是ExecWB. 它通过WebBrowser实现了一个 IOleCommandTarget 接口的Exec的包装实现。 在 ExecWB 方法 被创建前, 你不可以直接从VB中调用IOleCommandTarget::Exec, 因为VB不可访问 IOleCommandTarget 接口 ,因而VB不可直接使用该接口的ExecWB方法。 IOleCommandTarget::Exec 方法过去大量使用,所以 WebBrowser 开发者决定创建ExecWB 以使事情变得容易。
Table 6-5. IWebBrowser2 Vtable 次序的方法
方法
|
描述
|
Navigate2
|
功能基于 Navigate 方法,不同在于 Navigate2 允许你导航到飞 URL 表达的地方,例如 Windows shell folder. (Windows shell folder 是指向标示符指针 , 或者 windows shell 命名空间中的 PIDL,)
|
QueryStatusWB
|
IoleCommandTarget 接口的 QueryStatus 方法在 WebBrowser. 中的包装实现
|
ExecWB
|
IoleCommandTarget 接口的 Exec 方法在 WebBrowser. 中的包装实现
|
ShowBrowserBar
|
显示或者隐藏特定的浏览器条 . 该方法仅仅用于 InternetExplorer 对象
|
为什么你无论如何都要调用ExecWB方法?因为它提供了你需要的功能(通过IOleCommandTarget::Exec)不是暴露于webbrowser接口。你大概疑惑于为社么开发者不实现扩展属性和方法。记住:COM规则是一旦接口发表就不可改变。所以你不能够不能增加功能而不创建新的接口。
ExecWB 方法允许WebBrowser 开发者增加新的功能而不用创建新的接口。再之, 那是由WebBrowser 通过 ExecWB 代表性的暴露不常用的工的途径, 譬如调用 Save As 对话框或者缩放web页的字体。 ExecWB 工作的方法是传递一个你想调用的command ID 和必需的参数. 太多的 command IDs ,他们包含于OLECMDID实现文档头文件he DocObj.h .
作为举例, 支持缩放web页的内容字体。Internet Explorer 允许你通过View菜单的Text Size子菜单改变字体的大小从最小到最大。 ExecWB 方法暴露了允许你改变显示在浏览器中的文字大小。对于Zoom 命令, 你可指定特殊值0, 1, 2, 3, or 4, 0 是最小字体 ,4是最大字体。以下举例为改变字体为最大(VB):
WebBrowser1.ExecWB OLECMDID_ZOOM, OLECMDEXECOPT_DONTPROMPTUSER, _CLng(4), Null
再次代码中, 我调用 ExecWB 方法, 传递OLECMDID_ZOOM 常量给第一个参数. 此常量指定 zoom 操作将被执行。 第二个参数传递给ExecWB 不要提示用户。另外的选择, 你可以提醒用户而是用OLECMDEXECOPT_PROMPTUSER. (见 DocObj.h.)
第三个输入参数指示要设定的文字尺寸。我想是文字尽可能的大,所以我指定了4 。注意我在调用中使用了VB的Clng函数包装此值,转换我指定的此值为一个variant—输入需要的类型.最后为一个输出参数包含任何返回值。因为返回值不需要关心,我传递Null.
属性 IWebBrowser2 接口有8个属性。 (Table 6-6 按照vtable次序展示其)。他们都很直观,我仅仅解释恰宏很特别的一个—AddressBar.
Table 6-6. IWebBrowser2 Properties in Vtable Order
属性
|
描述
|
ReadyState
|
返回 WebBrowser 的状态 ( 换句话讲 ,该属性指示文档是否完成装载 ). 尽管你可以使用 ReadyState 属性 , 使用DocumentComplete 时间检测文档是否装载还是比较好些。 ( 那意味着所有 HTML 和文档被装载
|
Offline
|
. 返回或者设置检测 webbrowser 是否处于脱机模式的变量
|
Silent
|
返回或设置 WebBrowser 是否处于沉默模式。如果处于沉默模式,意味着没有对话框可以被显示 .
|
RegisterAsBrowser
|
. 设置或者检测 Webbrowser 是否是作为顶层浏览器被登记
|
RegisterAsDropTarget
|
. 设置或返回 WebBrowser 是否作为导航的拖放对象 。如果登记委托放对象 , 用户可直接拖放连接到浏览器
|
TheaterMode
|
返回或者设置 Internet Explorer 是否处于 theater 或者 normal window 模式 . 。在 theater 模式 , Internet Explorer 占据整个屏幕就像处于 FullScreen 模式,但也有最小化的用户接口元素 ( 此属性仅仅展示于 InternetExplorer 对象 )
|
AddressBar
|
显示或者隐藏地址栏 ( 此属性仅仅展示于 InternetExplorer 对象 )
|
Resizable
|
返回或者设置 Internet Explorer 是否可被调整大小 , 你可利用此属性防止用户改变 webbrowser 的大小 ( 此属性仅仅展示于InternetExplorer 对象 )
|
AddressBar 属性允许你显示/隐藏Internet Explorer 地址栏—一个包含可输入URL的文本框 允许你导航到某个Url。 能够显示或者隐藏地址条允许你完全控制你的用户的导航体验
在你的企业网络或者中小学控制用户导航体验.在此环境下,你将控制用户的导航以至于可确定某些不恰当地页面不可访问。你可创建你自己的浏览器。但是如果你没有时间和资源这么做,你可以自动化IE来代替.自动化IE允许你管掉所有的用户界面允许用户导航到某个web页,像菜单条, 工具条,以地址栏. 之后你可建立一定数量的可访问web页连接列表给用户。
关掉这些用户接口很容易. VB代码:
InternetExplorer1.AddressBar = False
InternetExplorer1.ToolBar = False
InternetExplorer1.MenuBar = False