Navigation:  Internet Development > WebBrowser Control > Interfaces > IWebBrowser2 >

Navigate

Previous pageReturn to chapter overviewNext page

描述

 

浏览到由URL或由完整路径标识的文件标识的资源。

 

C++ 语法

 

HRESULT Navigate(

   BSTR bstrUrl,

   VARIANT *vFlags,

   VARIANT *vTargetFrameName,

   VARIANT *vPostData,

   VARIANT *vHeaders

);

 

PowerBASIC 语法

 

METHOD Navigate ( _

   BYVAL bstrUrl AS WSTRING, _

   BYREF vFlags AS VARIANT, _

   BYREF vTargetFrameName AS VARIANT, _

   BYREF vPostData AS VARIANT, _

   BYREF vHeaders AS VARIANT _

)

 

参数

 

bstrUrl

[in]一个WSTRING表达式,其计算结果为要显示的资源的URL,完整路径或通用命名约定(UNC)位置和名称。

vFlags

[in]指向一个类型为long的VARIANT的指针,指定是否将资源添加到历史记录列表,是从缓存读取还是写入,以及是否在新窗口中显示资源。该变量可以是由BrowserNavConstants枚举定义的值的组合。

vTargetFrameName

[in]指向VARIANT类型字符串的指针,其中包含显示资源的框架的名称。此参数的可能值为:

_BLANK

将链接加载到新的未命名窗口中。

_PARENT

将链接加载到链接所在文档的直接父项中。

_SELF

将链接加载到链接被点击的同一个窗口中。

_TOP

将链接加载到当前窗口的正文中。

<WINDOW_NAME>

一个命名的HTML框架。如果没有与指定目标名称匹配的框架或窗口,则会为指定的链接打开一个新窗口。

vPostData

[in]指向要使用HTTP POST事务发送的数据的指针。例如,POST事务用于发送由HTML表单收集的数据。如果此参数未指定任何帖子数据,导航发出HTTP GET事务。如果URL不是HTTPURL,则忽略此参数。

vHeaders

[in]指向包含要发送到服务器的HTTP头的值的指针。这些标题将添加到默认的Microsoft Internet Explorer标头。标题可以指定服务器所需的操作,传递到服务器的数据类型或状态代码等内容。如果URL不是HTTPURL,则忽略此参数。

 

OBJRESULT

 

返回以下值之一:

 

S_OK

操作成功。

E_INVALIDARG

一个或多个参数无效。

E_OUTOFMEMORY

内存不足。

 

备注

 

PostData指定的帖子数据作为SAFEARRAY数据类型结构传递。VARIANT应为VT_ARRAY类型,并指向SAFEARRAY数据类型.SAFEARRAY数据类型应该是元素类型VT_UI1,维度一,元素数等于帖子数据的字节数。

 

WebBrowser控件或InternetExplorer对象可以浏览到本地文件系统,网络或万维网上的任何位置。使用导航方法告诉浏览器要浏览的位置。通过在应用程序中添加一个文本框,您可以让用户指定要浏览的位置,然后将该位置传递给导航方法。

 

在Internet Explorer 6或更高版本中,您只能在托管WebBrowser控件的应用程序的同一个域内导航代码。否则,此方法被禁用。