Compartir a través de

Información general del panel Acciones

Importante

La característica Acciones se ha retirado de Microsoft Word a partir de Office 2024. Esta característica solo está disponible en Microsoft Word con las siguientes versiones de Office:

  • Microsoft 365
  • Office LTSC Professional Plus 2021
  • Office LTSC Standard 2021
  • Office Professional Plus 2016, 2019
  • Estándar de Office 2016, 2019

Un panel de acciones es un panel de tareas acciones de documento personalizable que está asociado a un documento específico de Microsoft Office Word o a un libro de Microsoft Office Excel. El panel de acciones se hospeda dentro del panel de tareas de Office junto con otros paneles de tareas integrados, como el panel de tareas Origen XML en Excel o el panel de tareas Estilos y formato de Word. Puede usar controles de Windows Forms o controles WPF para diseñar la interfaz de usuario del panel de acciones.

Se aplica a: La información de este tema se aplica a proyectos de nivel de documento para Excel y Word. Para obtener más información, vea Características disponibles por aplicación de Office y tipo de proyecto.

Solo puede crear un panel de acciones en una personalización de nivel de documento para Word o Excel. No se puede crear un panel de acciones en un complemento de VSTO. Para obtener más información, vea Características disponibles por aplicación de Office y tipo de proyecto.

Nota:

El panel de acciones difiere de los paneles de tareas personalizados. Los paneles de tareas personalizados están asociados a la aplicación, no a un documento específico. Puede crear paneles de tareas personalizados en complementos de VSTO para algunas aplicaciones de Microsoft Office. Para obtener más información, consulte Paneles de tareas personalizados.

Mostrar el panel de acciones

El panel de acciones se representa mediante la ActionsPane clase . Al crear un proyecto de nivel de documento, una instancia de esta clase está disponible para el código mediante el ActionsPane campo de la ThisWorkbook clase (para Excel) o ThisDocument (para Word) del proyecto. Para mostrar el panel de acciones, agregue un control de Windows Forms a la Controls propiedad del ActionsPane campo. En el ejemplo de código siguiente se agrega un control denominado actions al panel de acciones.

this.ActionsPane.Controls.Add(actions);

El panel de acciones se vuelve visible en tiempo de ejecución en cuanto se agrega explícitamente un control. Una vez que se muestre el panel de acciones, puede agregar o quitar controles dinámicamente en respuesta a las acciones del usuario. Normalmente, se agrega el código para mostrar el panel de acciones en el Startup controlador de eventos de ThisDocument o ThisWorkbook para que el panel de acciones esté visible cuando el usuario abra el documento por primera vez. Sin embargo, es posible que quiera mostrar el panel de acciones solo en respuesta a la acción de un usuario en el documento. Por ejemplo, puede agregar el código al evento Click de un control en el documento.

Agregar varios controles al panel de acciones

Al agregar varios controles al panel de acciones, debe agrupar los controles en un control de usuario y, a continuación, agregar el control de usuario a la Controls propiedad . Este proceso incluye los pasos siguientes:

  1. Cree la interfaz de usuario (UI) del panel de acciones agregando un elemento Control de panel de acciones o Control de usuario al proyecto. Ambos elementos incluyen una clase personalizada de Windows Forms UserControl . Los elementos Control de panel de acciones y Control de usuario son equivalentes; la única diferencia es su nombre.

  2. Agregue controles de Windows Forms al UserControl mediante el diseñador o escribiendo código.

    Nota:

    También puede agregar controles WPF al panel de acciones agregando un WPF UserControl a Windows Forms UserControl. Para obtener más información, vea Usar controles WPF en soluciones de Office.

  3. Agregue una instancia del control de usuario personalizado a los controles contenidos en el ActionsPane campo de la ThisWorkbook clase (para Excel) o ThisDocument (para Word) del proyecto.

    Para obtener ejemplos que muestran este proceso con más detalle, vea Cómo: Agregar un panel de acciones a documentos de Word o libros de Excel.

Ocultar el panel de acciones

Aunque la ActionsPane clase tiene un Hide método y una Visible propiedad, no se puede quitar el panel de acciones de la interfaz de usuario mediante ningún miembro de la ActionsPane propia clase. Al llamar al Hide método o establecer la Visible propiedad en false , solo se ocultan los controles del panel de acciones; no oculta el panel de tareas.

Para ocultar el panel de tareas de la solución, tiene varias opciones:

  • En Word, establezca la Visible propiedad del objeto TaskPane que representa el panel de tareas de Acciones de Documento en false. El ejemplo de código siguiente está diseñado para ejecutarse desde la ThisDocument clase del proyecto.

    this.Application.TaskPanes[Word.WdTaskPanes.wdTaskPaneDocumentActions].Visible = false;

  • En Excel, establezca la DisplayDocumentActionTaskPane propiedad del Application objeto en false. El ejemplo de código siguiente está diseñado para ejecutarse desde la ThisWorkbook clase del proyecto.

    this.Application.DisplayDocumentActionTaskPane = false;

  • Para Word o Excel, también puede establecer la Visible propiedad de la barra de comandos que representa el panel de tareas en false. Ejemplo de código siguiente está diseñado para ejecutarse desde la clase ThisDocument o ThisWorkbook de su proyecto.

    this.Application.CommandBars["Task Pane"].Visible = false;

Borrar el panel de acciones cuando se abre el documento

Cuando un usuario guarda el documento mientras el panel de acciones está visible, el panel de acciones está visible cada vez que se abre el documento, independientemente de que el panel de acciones contenga controles o no. Si desea controlar cuando se muestra, llame al método Clear del campo ActionsPane en el controlador de eventos Startup de ThisDocument o ThisWorkbook para asegurarse de que el panel de acciones no esté visible cuando se abra el documento.

Determinar cuándo se cierra el panel de acciones

No hay ningún evento que se genere cuando se cierra el panel de acciones. Aunque la ActionsPane clase tiene un VisibleChanged evento, este evento no se genera cuando el usuario final cierra el panel de acciones. En su lugar, este evento se genera cuando los controles del panel de acciones están ocultos llamando al Hide método o estableciendo la Visible propiedad en false.

Cuando el usuario cierra el panel de acciones, el usuario puede volver a mostrarlo realizando uno de los procedimientos siguientes en la interfaz de usuario (UI) de la aplicación.

Para mostrar el panel de acciones mediante la interfaz de usuario de Word o Excel

  1. En la cinta de opciones, haga clic en la pestaña Ver .

  2. En el grupo Mostrar u ocultar , haga clic en el botón de alternancia Acciones del documento .

Eventos del panel de acciones del programa

Puede agregar varios controles de usuario al panel de acciones y, a continuación, escribir código para responder a eventos en el documento mostrando y ocultando los controles de usuario. Si asigna elementos de esquema XML al documento, puede mostrar determinados controles de usuario en el panel de acciones siempre que el punto de inserción esté dentro de uno de los elementos XML. Para obtener más información, vea Cómo: Asignar esquemas a documentos de Word dentro de Visual Studio y Cómo: Asignar esquemas a hojas de cálculo dentro de Visual Studio.

También puede escribir código para responder a los eventos de cualquier objeto, incluido el control de host, la aplicación o los eventos de documento. Para obtener más información, consulta Guía paso a paso: Programa contra eventso de un control NamedRange.

Vincular datos a los controles en el panel de acciones

Los controles del panel de acciones tienen las mismas funcionalidades de enlace de datos que los controles de Windows Forms. Puede enlazar los controles a orígenes de datos como conjuntos de datos, conjuntos de datos tipados y XML. Para obtener más información, consulte Vinculación de datos y Windows Forms.

Puede enlazar controles en el panel de acciones y los controles del documento al mismo conjunto de datos. Por ejemplo, puede crear una relación de maestro/detalle entre los controles del panel de acciones y los controles de la hoja de cálculo. Para obtener más información, vea Tutorial: Enlazar datos a controles en un panel de acciones de Excel.

Validar datos en controles de panel de acciones

Si se muestra un cuadro de mensaje en el controlador de eventos Validating de un control en el panel de acciones, el evento podría generarse una segunda vez al pasar el foco del control al cuadro de mensaje. Para evitar este problema, use un ErrorProvider control para mostrar los mensajes de error de validación.

Orden de apilamiento de controles de usuario

Si usa varios controles de usuario, puede escribir código para apilar correctamente los controles de usuario en el panel de acciones, tanto si está acoplado verticalmente como si lo está horizontalmente. Puede establecer el orden de apilamiento de los controles de usuario en el panel de acciones mediante la enumeración StackStyle de la propiedad StackOrder. Para obtener más información, vea Cómo: Gestionar el diseño del control en los paneles de acciones.

La StackOrder propiedad puede tomar los siguientes StackStyle valores de enumeración.

Estilo de apilamiento Definición
DesdeBottom Apilar desde la parte inferior del panel de acciones.
DesdeIzquierda Apilar desde la parte izquierda del panel de acciones.
DesdeDerecho Apilar desde la parte derecha del panel de acciones.
DesdeTop Apilar desde la parte superior del panel de acciones.
Ninguno Sin orden de apilamiento definido; el orden está controlado por el desarrollador.

El código siguiente establece la StackOrder propiedad para apilar los controles de usuario desde la parte superior del panel de acciones.

this.ActionsPane.StackOrder = Microsoft.Office.Tools.StackStyle.FromTop;

Controles de anclaje

Si el usuario cambia el tamaño del panel de acciones en tiempo de ejecución, los controles pueden cambiar el tamaño con el panel de acciones. Puede usar la Anchor propiedad de un control de Windows Forms para anclar controles al panel de acciones. También puede anclar los controles de Windows Forms al control de usuario de la misma manera. Para obtener más información, vea Cómo: Anclar controles en formularios de Windows Forms.

Cambiar el tamaño del panel de acciones

No puede cambiar directamente el tamaño de un ActionsPane porque ActionsPane está incrustado en el panel de tareas. Sin embargo, puede cambiar mediante programación el ancho del panel de tareas estableciendo la Width propiedad del CommandBar que representa el panel de tareas. Puede cambiar el alto del panel de tareas si está acoplado horizontalmente o está flotante.

No se recomienda cambiar el tamaño del panel de tareas mediante programación porque el usuario debe poder seleccionar el tamaño del panel de tareas que mejor se adapte a sus necesidades. Sin embargo, si debe cambiar el tamaño del ancho del panel de tareas, puede usar el código siguiente para lograr esta tarea.

this.CommandBars["Task Pane"].Width = 200;

Cambiar la posición del panel de acciones

No se puede cambiar la posición ActionsPane directamente porque está incrustada en el panel de tareas. Sin embargo, puede mover el panel de tareas mediante programación estableciendo la Position propiedad del CommandBar que representa el panel de tareas.

No se recomienda cambiar la posición del panel de tareas mediante programación porque el usuario debe poder elegir la posición del panel de tareas en la pantalla que mejor se adapte a sus necesidades. Sin embargo, si debe mover el panel de tareas a una posición determinada, puede usar el código siguiente para lograr esta tarea.

this.CommandBars["Task Pane"].Position =
    Microsoft.Office.Core.MsoBarPosition.msoBarLeft;

Nota:

Los usuarios finales pueden cambiar la posición manual del panel de tareas en cualquier momento. No hay ninguna manera de asegurarse de que el panel de tareas permanecerá acoplado en la posición que indique mediante programación. Sin embargo, puede comprobar si hay cambios de orientación y asegurarse de que los controles del panel de acciones se apilan en la dirección correcta. Para obtener más información, vea Cómo: Gestionar el diseño del control en los paneles de acciones.

Establecer las Top propiedades y Left de ActionsPane no cambia su posición porque el ActionsPane objeto está incrustado en el panel de tareas.

Si el panel de tareas no está acoplado, puede establecer las propiedades Top y Left del CommandBar que representa el panel de tareas. El siguiente código mueve un panel de tareas desacoplado a la esquina superior izquierda del documento.

if (this.CommandBars["Task Pane"].Position == 
    Microsoft.Office.Core.MsoBarPosition.msoBarFloating)
{
    this.CommandBars["Task Pane"].Top = 0;
    this.CommandBars["Task Pane"].Left = 0;
}

Contenido relacionado