Export (0) Print
Expand All

HtmlTaskPane.Navigate Method

Office 2010

Loads the specified HTML document into the custom task pane.

Namespace:  Microsoft.Office.InfoPath
Assembly:  Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)

public abstract void Navigate(
	string url
)

Parameters

url
Type: System.String

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

ExceptionCondition
WebException

An error occurred while attempting to open the specified URL.

ArgumentNullException

The parameter passed to this method is a null reference (Nothing in Visual Basic).

ArgumentException

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

NoteNote

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 InfoPath Filler.

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");
Show:
© 2014 Microsoft