HTMLTaskPaneObject Interfaz
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa un panel de tareas personalizado en un formulario de Microsoft InfoPath que está asociado a una ventana.
public interface class HTMLTaskPaneObject : Microsoft::Office::Interop::InfoPath::SemiTrust::HTMLTaskPane
[System.Runtime.InteropServices.Guid("096cd548-0786-11d1-95fa-0080c78ee3bb")]
public interface HTMLTaskPaneObject : Microsoft.Office.Interop.InfoPath.SemiTrust.HTMLTaskPane
type HTMLTaskPaneObject = interface
interface HTMLTaskPane
interface TaskPane
Public Interface HTMLTaskPaneObject
Implements HTMLTaskPane
- Atributos
- Implementaciones
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 Navigate(String) método 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.
<span class="label">HTMLTaskPane</span> oTaskPane = (HTMLTaskPane)thisXDocument.View.Window.TaskPanes[0];
// Navigate based on url specified.
oTaskPane.Navigate("taskpane2.html");
}
En el ejemplo siguiente, la Item[Object] propiedad de la TaskPanesCollection colección se usa para obtener una referencia al TaskPaneObject objeto que representa el panel de tareas personalizado. A continuación, el código llama a una función de scripting definida en el código HTML del panel de tareas personalizado mediante la HTMLDocument propiedad del objeto HTMLTaskPane , que hereda 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.
<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);
}
}
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. Para obtener información sobre la interfaz COM, incluido un vínculo a las descripciones de sus miembros, consulteHTMLTaskPane .
El objeto HTMLTaskPane proporciona una serie de propiedades y métodos para trabajar con el panel de tareas personalizado de InfoPath, y proporciona propiedades y métodos del TaskPaneObject objeto.
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 TaskPaneType propiedad devuelve 0, el panel de tareas es un panel de tareas personalizado y el objeto HTMLTaskPane proporciona las propiedades y los métodos disponibles. Si la propiedad TaskPaneType devuelve cualquier otro valor, se trata de un panel de tareas incorporado y las propiedades son las que proporciona el objeto TaskPane.
La propiedad TaskPaneType se basa en la XdTaskPaneType enumeración . Estos valores enumerados también se usan como argumentos para la Item[Object] propiedad de la TaskPanesCollection colección para devolver una referencia a un tipo especificado de panel de tareas.
Nota: No se pueden llamar a las propiedades y métodos del objeto HTMLTaskPane durante un _XDocumentEventSink2_OnLoadEventHandler evento porque la vista aún no se carga cuando se produce este evento y los paneles de tareas están asociados a la vista.
Propiedades
HTMLDocument |
Obtiene una referencia a un objeto de documento HTML del panel de tareas personalizado de Microsoft InfoPath. (Heredado de HTMLTaskPane) |
HTMLWindow |
Obtiene una referencia a un objeto de ventana HTML del panel de tareas personalizado de Microsoft InfoPath. (Heredado de HTMLTaskPane) |
TaskPaneType |
Obtiene un valor que indica el tipo de panel de tareas representado por el HTMLTaskPaneObject objeto , que siempre es un panel de tareas personalizado. (Heredado de HTMLTaskPane) |
Visible |
Obtiene o establece un valor que indica que el panel de tareas representado por el HTMLTaskPaneObject objeto, que siempre es un panel de tareas personalizado, está visible en la interfaz de usuario de Microsoft InfoPath. (Heredado de HTMLTaskPane) |
Métodos
Navigate(String) |
Carga el documento HTML especificado en el panel de tareas personalizado de Microsoft InfoPath. (Heredado de HTMLTaskPane) |