HTMLTaskPaneObject Interface
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa um painel de tarefas personalizado em um formulário do Microsoft InfoPath associado a uma janela.
public interface class HTMLTaskPaneObject : Microsoft::Office::Interop::InfoPath::HTMLTaskPane
[System.Runtime.InteropServices.Guid("096CD548-0786-11D1-95FA-0080C78EE3BB")]
public interface HTMLTaskPaneObject : Microsoft.Office.Interop.InfoPath.HTMLTaskPane
type HTMLTaskPaneObject = interface
interface HTMLTaskPane
Public Interface HTMLTaskPaneObject
Implements HTMLTaskPane
- Derivado
- Atributos
- Implementações
Exemplos
No exemplo a seguir, a propriedade P:Microsoft.Office.Interop.InfoPath.TaskPanes.Item(System.Object) da coleção T:Microsoft.Office.Interop.InfoPath.TaskPanesCollection é usada para obter uma referência ao objeto T:Microsoft.Office.Interop.InfoPath.TaskPaneObject que representa o painel de tarefas personalizado. Em seguida, o código chama o Navigate(String) método do objeto HTMLTaskPane para abrir um arquivo HTML.
public void CustomTaskPaneNavigation()
{
// Get a reference to the custom task pane. It is always index [0] in the TaskPanes collection.
<span class="label">HTMLTaskPane</span> oTaskPane = (HTMLTaskPane)thisXDocument.View.Window.TaskPanes[0];
// Navigate based on url specified.
oTaskPane.Navigate("taskpane2.html");
}
No exemplo a seguir, a Item[Object] propriedade da TaskPanesCollection coleção é usada para obter uma referência ao TaskPaneObject objeto que representa o painel de tarefas personalizado. Em seguida, o código chama uma função de script definida no código HTML do painel de tarefas personalizado usando a HTMLDocument propriedade do objeto HTMLTaskPane , que é herdado pelo objeto TaskPane .
// Ensure View has loaded before trying to access the task pane.
if (thisXDocument.View != null)
{
// Get a reference to the custom task pane. It is always the 0-th
// task pane in the TaskPanes collection.
<span class="label">HTMLTaskPane</span> custom = (HTMLTaskPane) thisXDocument.View.Window.TaskPanes[0];
// Ensure that the task pane is completely loaded.
if (custom != null && custom.HTMLDocument.readyState == "complete")
{
mshtml.IHTMLWindow2 window = custom.HTMLDocument.parentWindow;
object[] args = new object[] {"ViewID"};
// call into script through CLR late binding mechanism
window.GetType().InvokeMember(
"SelectView", // late bound method
System.Reflection.BindingFlags.InvokeMethod | // binding flags
System.Reflection.BindingFlags.DeclaredOnly |
System.Reflection.BindingFlags.Public |
System.Reflection.BindingFlags.Instance,
null, // binder object
window, // target object
args);
}
}
Comentários
This type is a wrapper for a coclass that is required by managed code for COM interoperability. Use this type to access the members of the COM interface implemented by this coclass. Para obter informações sobre a interface COM, incluindo um link para descrições de seus membros, consulteHTMLTaskPane.
O objeto HTMLTaskPane fornece várias propriedades e métodos para trabalhar com o painel de tarefas personalizado do InfoPath e fornece propriedades e métodos do TaskPaneObject objeto.
As propriedades e os métodos disponíveis para um painel de tarefas do InfoPath são determinados pelo tipo de painel de tarefas com o qual você está trabalhando. Se a TaskPaneType propriedade retornar 0, o painel de tarefas será um painel de tarefas personalizado e as propriedades e métodos disponíveis serão fornecidos pelo objeto HTMLTaskPane . Se a propriedade TaskPaneType retornar qualquer outro valor, o painel de tarefas será um painel de tarefas interno e as propriedades serão fornecidas pelo objeto TaskPane .
A propriedade TaskPaneType é baseada na XdTaskPaneType enumeração. Esses valores enumerados também são usados como argumentos para a Item[Object] propriedade da TaskPanesCollection coleção para retornar uma referência a um tipo especificado de painel de tarefas.
Observação: as propriedades e os métodos do objeto HTMLTaskPane não podem ser chamados durante um _XDocumentEventSink2_OnLoadEventHandler evento porque o modo de exibição ainda não é carregado quando esse evento ocorre, e os painéis de tarefa estão associados ao modo de exibição.
Propriedades
HTMLDocument |
Obtém uma referência a um objeto de documento HTML do painel de tarefas personalizado do Microsoft Office InfoPath 2003. (Herdado de HTMLTaskPane) |
HTMLWindow |
Obtém uma referência a um objeto de janela HTML do painel de tarefas personalizado do Microsoft Office InfoPath 2003. (Herdado de HTMLTaskPane) |
TaskPaneType |
Obtém um valor que indica o tipo de painel de tarefas representado pelo HTMLTaskPaneObject objeto, que é sempre um painel de tarefas personalizado. (Herdado de HTMLTaskPane) |
Visible |
Obtém ou define um valor que indica que o painel de tarefas representado pelo HTMLTaskPaneObject objeto, que é sempre um painel de tarefas personalizado, está visível na interface do usuário do Microsoft Office InfoPath 2003. (Herdado de HTMLTaskPane) |
Métodos
Navigate(String) |
Carrega o documento HTML especificado no painel de tarefas personalizado do Microsoft Office InfoPath 2003. (Herdado de HTMLTaskPane) |