NavigateAndFind method

Navigates to the specified URL and selects the specified text.

Syntax

var retval = external.NavigateAndFind(URL, strQuery, varTargetFrame);

Parameters

URL [in]

Type: String

A String that specifies the URL of a Web page.

strQuery [in]

Type: String

A String that specifies the text to highlight on the Web page specified by URL.

varTargetFrame [in]

Type: VARIANT

Variant of type String that specifies the name of the target frame to query.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Standards information

There are no standards that apply here.

Remarks

This method requires a full qualified path, including a location prefix, for example, http://, c:\, and so on.

The target frame argument might be empty.

This method is not supported in Introduction to HTML Applications (HTAs).

This method requires a user-initiated action to open a pop-up window, such as clicking on a link, or tabbing to a link and pressing enter. The Pop-up Blocker feature in Microsoft Internet Explorer 6 blocks windows that open without being initiated by the user.

Examples

This example uses the NavigateAndFind method to search for a word or phrase on another page.

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/NavigateAndFind.htm

JavaScript


<head>
<script type="text/javascript">
function fnNAF(){
   window.external.NavigateAndFind(
       "http://www.domain.ext/path/file.htm",
       oSearchText.options[oSearchText.selectedIndex].text,"");
}
</script>
</head>
<body>
<select id=oSearchText onchange="fnNAF()">
<option>Persnickety
<option>Seattle rain
<option;> ...
</select>
</body>