Agregar un panel de acciones a documentos de Word o libros de Excel

Para agregar un panel de acciones a un documento de Microsoft Office Word o a un libro de Microsoft Excel, cree primero un control de usuario de Windows Forms. A continuación, agregue el control de usuario a la Controls propiedad del campo (Word) o ThisWorkbook.ActionsPane del campo (Excel) en el ThisDocument.ActionsPane proyecto.

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, consulte Características disponibles por aplicación de Office lication y tipo de proyecto.

Nota:

Es posible que tu equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio en las siguientes instrucciones. La edición de Visual Studio que se tenga y la configuración que se utilice determinan estos elementos. Para más información, vea Personalizar el IDE de Visual Studio.

Crear el control de usuario

En el procedimiento siguiente se muestra cómo crear el control de usuario en un proyecto de Word o Excel. También agrega un botón al control de usuario que escribe texto en el documento o libro cuando se hace clic en él.

Para crear el control de usuario

  1. Abra el proyecto de nivel de documento de Word o Excel en Visual Studio.

  2. En el menú Proyecto , haga clic en Agregar nuevo elemento.

  3. En el cuadro de diálogo Agregar nuevo elemento , seleccione Control de panel de acciones, asígnele el nombre HelloControl y haga clic en Agregar.

    Nota:

    También puede agregar un elemento control de usuario al proyecto. Las clases generadas por los elementos Control de panel de acciones y Control de usuario son funcionalmente equivalentes.

  4. En la pestaña Formularios Windows Forms del Cuadro de herramientas, arrastre un control Button al control.

    Nota:

    Si el control no está visible en el diseñador, haga doble clic en HelloControl en Explorador de soluciones.

  5. Agregue el código al Click controlador de eventos del botón. En el ejemplo siguiente se muestra el código de un documento de Microsoft Office Word.

    private void button1_Click(object sender, System.EventArgs e)
    {
        Globals.ThisDocument.Paragraphs[1].Range.Text = "Hello World!";
    }
    
  6. En C#, debe agregar un controlador de eventos para el clic del botón. Puede colocar este código en el HelloControl constructor después de la llamada a InitializeComponent.

    Para obtener información sobre cómo crear controladores de eventos, vea How to: Create Event Handlers in Office Projects.

    public HelloControl()
    {
        InitializeComponent();
        this.button1.Click += new EventHandler(this.button1_Click);
    }
    

Agregar el control de usuario al panel de acciones

Para mostrar el panel de acciones, agregue el control de usuario a la Controls propiedad del ThisDocument.ActionsPane campo (Word) o ThisWorkbook.ActionsPane del campo (Excel).

Para agregar el control de usuario al panel de acciones

  1. Agregue el código siguiente a la ThisDocument clase o ThisWorkbook como una declaración de nivel de clase (no agregue este código a un método).

    private HelloControl hello = new HelloControl();
    
  2. Agregue el código siguiente al ThisDocument_Startup controlador de eventos de la ThisDocument clase o al ThisWorkbook_Startup controlador de eventos de la ThisWorkbook clase .

    this.ActionsPane.Controls.Add(hello);