NavigateAndFind method

  • Article

Navigates to the specified URL and selects the specified text.

Syntax

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

Parameters

  • URL [in]
    Type: BSTR

    A String that specifies the URL of a Web page.

  • strQuery [in]
    Type: BSTR

    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.

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

<HEAD>
<SCRIPT>
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>

See also

external

Reference

window

Conceptual

About the Pop-up Blocker