Share via


HtmlTaskPane.Navigate Method

Loads the specified HTML document into the custom task pane.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

'Declaration
'Usage

Parameters

  • url
    The Uniform Resource Locator (URL) of the HTML document to navigate to.

Exceptions

Exception type Condition

WebException

An error occurred while attempting to open the specified URL.

ArgumentNullException

The parameter passed to this method is null.

ArgumentException

The parameter passed to this method isnot valid. For example, it is of the wrong type or format.

Remarks

Note

The Navigate method cannot be called from an event handler for the Loading event because the view is not yet loaded when this event occurs, and task panes are associated with the view.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed only from code running in forms opened in Microsoft Office InfoPath 2007.

Example

In the following example, the Navigate method of the HtmlTaskPane class is used to load an HTML file into the custom task pane. The HTML document that it loads is one that has been added as a resource file of the form template.

// Get a reference to the custom task pane. 
// It is always index [0] in the TaskPanes collection.
HtmlTaskPane oTaskPane = (Microsoft.Office.InfoPath.HtmlTaskPane)
   (this.CurrentView.Window.TaskPanes[0]);

// Navigate to new task pane based on url specified.
oTaskPane.Navigate("taskpane2.html");
' Get a reference to the custom task pane. It is always index (0) in 
' the TaskPanes collection.
Dim oTaskPane As HtmlTaskPane = _
   DirectCast(Me.CurrentView.Window.TaskPanes(0), _
   Microsoft.Office.InfoPath.HtmlTaskPane)

' Navigate to new task pane based on url specified.
oTaskPane.Navigate("taskpane2.html")

See Also

Reference

HtmlTaskPane Class
HtmlTaskPane Members
Microsoft.Office.InfoPath Namespace