Interfaz HTMLTaskPaneObject

Representa un panel de tareas personalizado de un formulario de Microsoft InfoPath asociado a una ventana.

Espacio de nombres:  Microsoft.Office.Interop.InfoPath.SemiTrust
Ensamblado:  Microsoft.Office.Interop.InfoPath.SemiTrust (en Microsoft.Office.Interop.InfoPath.SemiTrust.dll)

Sintaxis

'Declaración
<GuidAttribute("096cd548-0786-11d1-95fa-0080c78ee3bb")> _
Public Interface HTMLTaskPaneObject _
    Inherits HTMLTaskPane, TaskPane
'Uso
Dim instance As HTMLTaskPaneObject

[GuidAttribute("096cd548-0786-11d1-95fa-0080c78ee3bb")]
public interface HTMLTaskPaneObject : HTMLTaskPane, 
    TaskPane

Comentarios

Este tipo es un contenedor para una coclase que requiere el código administrado para la interoperabilidad con COM. Use este tipo para acceder a los miembros de la interfaz COM que implementa esta coclase. Encontrará información sobre la interfaz COM, así como vínculos a las descripciones de sus miembros, enHTMLTaskPane.

El objeto HTMLTaskPane incluye varias propiedades y varios métodos para trabajar con el panel de tareas personalizado de InfoPath y proporciona propiedades y métodos del objeto TaskPaneObject.

Las propiedades y los métodos que están disponibles para un panel de tareas de InfoPath vienen determinados por el tipo de panel de tareas con que se trabaje. Si la propiedad TaskPaneType devuelve 0, el panel de tareas será personalizado y las propiedades y métodos que estén disponibles procederán del objeto HTMLTaskPane. Si la propiedad TaskPaneType devuelve cualquier otro valor, se tratará de un panel de tares integrado y sus propiedades procederán del objeto TaskPane.

La propiedad TaskPaneType se basa en la enumeración XdTaskPaneType. Estos valores enumerados también se utilizan como argumentos para la propiedad Item de la colección TaskPanesCollection para devolver una referencia al tipo de panel de tareas especificado.

Ejemplos

En el siguiente ejemplo, se utiliza la propiedad P:Microsoft.Office.Interop.InfoPath.SemiTrust.TaskPanes.Item(System.Object) de la colección T:Microsoft.Office.Interop.InfoPath.SemiTrust.TaskPanesCollection para obtener una referencia al objeto T:Microsoft.Office.Interop.InfoPath.SemiTrust.TaskPaneObject que representa al panel de tareas personalizado. A continuación, el código llama al método Navigate del objeto HTMLTaskPane para abrir un archivo HTML.

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");
}

En el siguiente ejemplo, se utiliza la propiedad Item de la colección TaskPanesCollection para obtener una referencia al objeto TaskPaneObject que representa al panel de tareas personalizado. A continuación, el código llama a una función de secuencia de comandos definida en el código HTML del panel de tareas personalizado mediante la propiedad HTMLDocument del objeto HTMLTaskPane, que es heredado por el 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.
 HTMLTaskPane 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);
 }
}

Vea también

Referencia

Miembros HTMLTaskPaneObject

Espacio de nombres Microsoft.Office.Interop.InfoPath.SemiTrust