HTMLTaskPane.Navigate method

Office 2013 and later

Loads the specified HTML document into the Microsoft InfoPath custom task pane.

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

void Navigate(
	string bstrURL
)

Parameters

bstrURL
Type: System.String

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

The Navigate method of the HTMLTaskPaneObject object is one of the methods inherited by the TaskPaneObject object when the type of the task pane is 0, which means that it is the custom task pane.

NoteNote

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

Important noteImportant

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.

In the following example, the Navigate method of the HTMLTaskPaneObject is used to load an HTML document into the custom task pane. The HTML document that it loads is one that is included in the form files of the form template:

public void CustomTaskPaneNavigation()
{
 // Get a reference to the custom task pane. It is always index [0] in the TaskPanes collection.   
 HTMLTaskPane oTaskPane = (HTMLTaskPane)thisXDocument.View.Window.TaskPanes[0];

 // Navigate based on url specified.
 oTaskPane.Navigate("taskpane2.html");
}
Show: