HtmlTaskPane.Navigate(String) Método

Definição

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Carrega o documento HTML especificado no painel de tarefas personalizado.

public:
 abstract void Navigate(System::String ^ url);

public abstract void Navigate (string url);

abstract member Navigate : string -> unit

Public MustOverride Sub Navigate (url As String)

Parâmetros

url

String

A URL (Uniform Resource Locator) do documento HTML para o qual navegar.

Exceções

WebException

Ocorreu um erro ao tentar abrir a URL especificada.

ArgumentNullException

O parâmetro passado para esse método é uma referência nula (Nada no Visual Basic).

ArgumentException

O parâmetro passado para esse método não é válido. Por exemplo, ele é do tipo ou formato errado.

Exemplos

No exemplo a seguir, o método Navigate da classe HtmlTaskPane é usado para carregar um arquivo HTML no painel de tarefas personalizado. O documento HTML que ele carrega é um que foi adicionado como um arquivo de recurso do modelo de formulário.

// 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")

Comentários

Observação: o método Navigate não pode ser chamado de um manipulador de eventos para o Loading evento porque o modo de exibição ainda não está carregado quando esse evento ocorre e os painéis de tarefa estão associados ao modo de exibição.

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.