描述
浏览到由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控件的应用程序的同一个域内导航代码。否则,此方法被禁用。