Administrar paneles de tareas personalizados en varias ventanas de la aplicación

Artículo
08/10/2011

Al crear un panel de tareas personalizado en una aplicación que utiliza varias ventanas para mostrar documentos y otros elementos, necesita pasos adicionales para asegurarse de que el panel de tareas está visible cuando el usuario espera que lo esté.

Se aplica a: la información de este tema se aplica a los proyectos de nivel de aplicación para las siguientes aplicaciones: Excel 2007 y Excel 2010; InfoPath 2007 e InfoPath 2010; Outlook 2007 y Outlook 2010; PowerPoint 2007 y PowerPoint 2010; Word 2007 y Word 2010. Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto de Office.

Los paneles de tareas personalizados de todas las aplicaciones están asociados a una ventana de marco de documento, que presenta una vista de un documento o un elemento al usuario. El panel de tareas sólo está visible cuando la ventana asociada está visible. Sin embargo, no todas las aplicaciones utilizan las ventanas de marco de documento de la misma manera.

Los grupos de aplicaciones siguientes tienen requisitos de desarrollo diferentes:

Outlook
Word, InfoPath y PowerPoint 2010
Excel y PowerPoint 2007

vínculo a vídeo Dispone de una demostración en vídeo relacionada en How Do I: Manage Task Panes in Word Add-ins?.

Outlook

Cuando crea un panel de tareas personalizado para Outlook, éste se asocia a una ventana de explorador o de inspector específica. Los exploradores son ventanas que muestran el contenido de una carpeta y los inspectores son ventanas que muestran un elemento, como un mensaje de correo electrónico o una tarea.

Si desea mostrar un panel de tareas personalizado con varias ventanas de explorador o de inspector, debe crear una nueva instancia del panel cuando se abre una nueva ventana de explorador o de inspector. Para ello, administre un evento que se provoque al crear una ventana de explorador o inspector y, a continuación, cree el panel de tareas en el controlador de eventos. También puede administrar los eventos del explorador y del inspector para ocultar o mostrar paneles de tareas en función de la ventana visible.

Para asociar el panel de tareas a un explorador o un inspector específico, use el método CustomTaskPaneCollection.Add(UserControl, String, Object) para crear el panel de tareas y pase el objeto Explorer o Inspector al parámetro window. Para obtener más información acerca de la creación de paneles de tareas personalizados, vea Información general sobre los paneles de tareas personalizados.

Para tener acceso a un tutorial que muestra cómo crear un panel de tareas para cada mensaje de correo electrónico que se abre, vea Tutorial: Mostrar paneles de tareas personalizados con mensajes de correo electrónico en Outlook.

Eventos de Outlook

Para supervisar el estado de las ventanas del explorador, puede administrar los siguientes eventos relacionados con el explorador:

Para supervisar el estado de las ventanas de inspector, puede administrar los siguientes eventos relacionados con el inspector:

Evitar varias instancias de un panel de tareas personalizado en Outlook

Para evitar que las ventanas de Outlook muestren varias instancias de un panel de tareas personalizado, quite explícitamente el panel de tareas personalizado de la colección CustomTaskPanes de la clase ThisAddIn cuando se cierra cada ventana. Llame al método Remove en un evento que se produce cuando se cierra una ventana, como ExplorerEvents_10_Event.Close o InspectorEvents_10_Event.Close.

Si no quita explícitamente el panel de tareas personalizado, las ventanas de Outlook pueden mostrar varias instancias del mismo. Outlook recicla a veces las ventanas, que una vez recicladas mantienen referencias a los paneles de tareas personalizados que estén adjuntos a ellas.

Word, InfoPath y PowerPoint 2010

Word, InfoPath y PowerPoint 2010 muestran cada documento en una ventana de marco de documento diferente. Al crear un panel de tareas personalizado para estas aplicaciones, el panel sólo se asocia a un documento concreto. Si el usuario abre un documento diferente, el panel de tareas personalizado se oculta hasta que el documento anterior está de nuevo visible.

Si desea mostrar un panel de tareas personalizado con varios documentos, cree una nueva instancia del panel cuando el usuario cree un nuevo documento o abra un documento existente. Para ello, administre eventos que se provoquen al crear o abrir un documento y, a continuación, cree el panel de tareas en los controladores de eventos. También puede administrar eventos de documento para ocultar o mostrar los paneles de tareas en función del documento visible.

Para asociar el recuadro de tareas a una ventana de documento específica, use el método CustomTaskPaneCollection.Add(UserControl, String, Object) para crear el recuadro de tareas, y pase un objeto Microsoft.Office.Interop.Word.Window (para Word), Microsoft.Office.Interop.InfoPath.WindowObject (para InfoPath) o Microsoft.Office.Interop.PowerPoint.DocumentWindow (para PowerPoint) al parámetro window.

Para obtener más información, vea Managing Task Panes in Multiple Word and InfoPath Documents. Este artículo trata específicamente de Word e InfoPath, pero los conceptos que incluye también se aplican a PowerPoint 2010, porque esta versión de PowerPoint tiene una interfaz de un único documento.

Eventos de Word

Para supervisar el estado de ventanas de documento en Word, puede administrar los eventos siguientes:

Eventos de InfoPath

Para supervisar el estado de ventanas de documento en InfoPath, puede administrar los eventos siguientes:

Eventos de PowerPoint

Para supervisar el estado de ventanas de documento en PowerPoint 2010, puede controlar los eventos siguientes:

Excel y PowerPoint 2007

Excel y PowerPoint 2007 crean una ventana de marco de documento para todos los documentos (es decir, para libros y presentaciones). Al crear un panel de tareas personalizado en estas aplicaciones, el panel de tareas está disponible en cada documento abierto de la aplicación. No es necesario realizar trabajo adicional para garantizar que el panel de tareas se muestra en cada documento.

Sin embargo, dependiendo del documento activo, podría desear ocultar o mostrar el panel de tareas o podría desear mostrar diferentes elementos de la interfaz de usuario o datos en el panel de tareas. Para ello, administre eventos que se provoquen al crear, abrir o activar un documento y, a continuación, actualice el panel de tareas en los controladores de eventos.

Eventos de Excel

Para supervisar el estado de los libros en Excel, puede administrar los eventos siguientes:

Eventos de PowerPoint

Para supervisar el estado de las presentaciones en PowerPoint 2007, puede controlar los eventos siguientes:

Ejemplo

El ejemplo de código siguiente muestra cómo ocultar o mostrar un panel de tareas personalizado en un controlador de eventos para el evento WorkbookActivate de un complemento de Excel. Cuando se activa cada libro, el panel de tareas sólo está visible si el libro se denomina SalesData.xls; de lo contrario, se oculta el panel de tareas. Para ejecutar este ejemplo, reemplace el controlador de eventos ThisAddIn_Startup predeterminado de la clase ThisAddIn con el código siguiente. Este ejemplo supone que su proyecto incluye un UserControl denominado UserControl1.

Dim myUserControl As UserControl1
Dim myCustomTaskPane As Microsoft.Office.Tools.CustomTaskPane

Private Sub ThisAddIn_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
Handles Me.Startup
    myUserControl = New UserControl1()
    myCustomTaskPane = Me.CustomTaskPanes.Add(myUserControl, "Sales Task Pane")
End Sub

Private Sub Application_WorkbookActivate(ByVal Wb As Excel.Workbook) _
    Handles Application.WorkbookActivate

    If Wb.Name = "SalesData.xlsx" Then
        myCustomTaskPane.Visible = True
    Else
        myCustomTaskPane.Visible = False
    End If
End Sub

private UserControl1 myUserControl;
private Microsoft.Office.Tools.CustomTaskPane myCustomTaskPane;

private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    this.Application.WorkbookActivate += new Excel.AppEvents_WorkbookActivateEventHandler(
        Application_WorkbookActivate);

    myUserControl = new UserControl1();
    myCustomTaskPane = this.CustomTaskPanes.Add(myUserControl, "Sales Task Pane");
}

void Application_WorkbookActivate(Excel.Workbook Wb)
{
    if (Wb.Name == "SalesData.xlsx")
        myCustomTaskPane.Visible = true;
    else
        myCustomTaskPane.Visible = false;
}