Tutorial: Cambiar el recuadro de acciones de acuerdo con el contexto del usuario

Artículo
08/10/2011

Importante La información que se incluye en este tema relacionada con Microsoft Word se presenta exclusivamente para beneficio y uso de individuos y organizaciones residentes fuera de los Estados Unidos y sus territorios, o que estén utilizando, o desarrollando programas que se ejecutan en, productos de Microsoft Word con licencia concedida por Microsoft antes de enero de 2010, fecha en que Microsoft quitó una implementación de funcionalidad concreta relacionada con XML personalizado de Microsoft Word. Puede que esta información relacionada con Microsoft Word no sea leída o utilizada por individuos u organizaciones residentes en los Estados Unidos o sus territorios que estén utilizando, o desarrollando programas que se ejecutan en, productos de Microsoft Word con licencia concedida por Microsoft después del 10 de enero de 2010; dichos productos no tendrán el mismo comportamiento que los productos con licencia anterior a esa fecha o comprados, y con licencia para su uso, fuera de los Estados Unidos.

En este tutorial se muestra cómo responder a los eventos XMLNode. Cuando un usuario mueve el cursor en un documento, los controles del panel de acciones se ocultan o se vuelven visibles.

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

En este tutorial se muestran las tareas siguientes:

Agregar controles al panel de acciones
Mostrar el panel de acciones cuando se abra la aplicación.
Ocultar y mostrar controles en el panel de acciones en función de las acciones del usuario en nodos XML.

Nota

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

Requisitos previos

Necesita los componentes siguientes para completar este tutorial:

Una edición de Visual Studio 2010 que incluye las herramientas para desarrolladores de Microsoft Office. Para obtener más información, vea [Configurar un equipo para desarrollar soluciones de Office](bb398242\(v=vs.100\).md).

Word 2007 o Word 2010.

Crear el proyecto

El primer paso consiste en crear un proyecto de documento de Word.

Para crear un nuevo proyecto

Cree un proyecto de documento de Word con el nombre My Dynamic Actions Pane. En el asistente, seleccione Crear un nuevo documento. Para obtener más información, consulte Cómo: Crear proyectos de Office en Visual Studio.

Visual Studio abre el nuevo documento de Word en el diseñador y agrega el proyecto Mi recuadro de acciones dinámicas al Explorador de soluciones.

Crear un esquema para asignarlo al documento

Para crear los nodos XML, arrastre elementos de un esquema XML al documento. Cree en primer lugar un archivo de esquema y, a continuación, cree un documento que corresponda al esquema y asigne los elementos al documento.

Para crear el esquema XML

Seleccione el proyecto Mi panel de acciones dinámicas en el Explorador de soluciones.
En el menú Proyecto, haga clic en Agregar nuevo elemento.

Aparecerá el cuadro de diálogo Agregar nuevo elemento.
En el panel Plantillas, seleccione Esquema XML.
Asigne al esquema el nombre ActionsPaneSample.xsd y haga clic en Agregar.
En el Explorador de soluciones, haga clic con el botón secundario del mouse en ActionsPaneSample.xsd y, a continuación, en Abrir con.
En el cuadro de diálogo Abrir con, seleccione Editor XML y, a continuación, haga clic en Aceptar.

Reemplace el texto del editor XML con el texto siguiente.

<?xml version="1.0" encoding="utf-8" ?>
<xs:schema targetNamespace="https://schemas.microsoft.com/vsto/samples" elementFormDefault="qualified"
    xmlns="https://schemas.microsoft.com/vsto/samples"
    xmlns:mstns="https://schemas.microsoft.com/vsto/samples"
    xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="Sample" type="SampleType"></xs:element>
  <xs:complexType name="SampleType">
    <xs:all>
      <xs:element name="Insert" type="InsertType" minOccurs="0" maxOccurs="1" />
      <xs:element name="Table" type="xs:string" minOccurs="0" maxOccurs="1" />
    </xs:all>
  </xs:complexType>
  <xs:complexType name="InsertType">
    <xs:sequence>
      <xs:element name="MemoTo" type="xs:string" minOccurs="1" maxOccurs="1"/>
      <xs:element name="MemoFrom" type="xs:string" minOccurs="1" maxOccurs="1"/>
      <xs:element name="MemoSubject" type="xs:string" minOccurs="1" maxOccurs="1"/>
    </xs:sequence>
  </xs:complexType>
</xs:schema>

Guarde el proyecto.

Agregar texto y código XML al documento

El documento para este tutorial tiene formato de memorando. Agregue el texto al documento y, a continuación, asigne los elementos XML a ubicaciones en el documento.

Para agregar texto al documento

En el Explorador de soluciones, haga clic con el botón secundario del mouse en ThisDocument.cs o en ThisDocument.vb y, a continuación, haga clic en Diseñador de vistas.
Agregue el texto siguiente al documento de Word.

MEMORANDO

Para:

De:

Asunto:

La tabla siguiente muestra la información de contacto solicitada:

Name

Dirección

Ciudad

Estado

Código postal

Nancy Davolio

507 - 20th Ave. E., Apt. 2A

Seattle

WA

98122

A continuación, asigne elementos XML al texto contenido en el memorando. Se creará un control XMLNode para cada elemento XML que asigne. El nombre del control XMLNode se obtiene agregando los nombres del elemento primario y del elemento secundario a la palabra Node. Por ejemplo, si asigna el elemento Insert del esquema anterior, el nombre será SampleInsertNode. Para obtener más información sobre controles, vea Información general sobre elementos y controles Host.

Para adjuntar el esquema a su documento

En la cinta de opciones, haga clic en la ficha Desarrollador.

Nota

Si la ficha Desarrollador no está visible, debe mostrarla primero. Para obtener más información, vea Cómo: Mostrar la pestaña Programador en la cinta de opciones.
En el grupo XML, haga clic en Esquema.

Se abrirá el cuadro de diálogo Plantillas y complementos.
En el cuadro de diálogo Plantillas y complementos, haga clic en la ficha Esquema XML y, a continuación, haga clic en Agregar esquema.
Vaya al esquema ActionsPaneSample.xsd anteriormente creado, que está situado en su directorio de proyecto, y haga clic en Abrir.
Haga clic en Aceptar en el cuadro de diálogo Configuración del esquema.
Haga clic en Aceptar para cerrar el cuadro de diálogo Plantillas y complementos.

Se abre el panel de tareas Estructura XML.

Para asignar elementos XML a su documento

Haga clic en el elemento Sample del panel de tareas Estructura XML.
Haga clic en Aplicar a todo el documento cuando se le pregunte.
Seleccione las tres líneas de texto que contienen To, From y Subject y haga clic en el elemento Insertar del panel de tareas Estructura XML.
Coloque el cursor después de Para:, presione la tecla TAB dos veces y haga clic en el elemento MemoTo para insertarlo.
Coloque el cursor después de De:, presione la tecla TAB dos veces y haga clic en el elemento MemoFrom.
Coloque el cursor después de Asunto:, presione la tecla TAB dos veces y haga clic en el elemento MemoSubject.
Seleccione la tabla de manera que quede resaltada toda la tabla y haga clic en el elemento Tabla para aplicarla.

Las etiquetas XML aparecen dentro de las celdas de la tabla.
Desactive la casilla Mostrar las etiquetas XML del documento.
Haga clic en Opciones XML en la parte inferior del panel de tareas Estructura XML.
Active la casilla Omitir el contenido mixto y haga clic en Aceptar.
Cierre el panel de tareas Estructura XML.

Agregar controles al panel de acciones

Para establecer el diseño de controles en el panel de acciones, se utiliza el diseñador de un control denominado control de panel de acciones, que es básicamente igual a un control de usuario. Puede arrastrar otros controles, como botones y cuadros de texto, al control de panel de acciones y organizarlos. Para cambiar el panel de acciones según el contexto de usuario, debe agregar y diseñar un control de panel de acciones para cada contexto y, a continuación, mostrarlos y ocultarlos según corresponda.

Este tutorial utiliza tres controles de panel de acciones. El primer control del panel de acciones contiene tres cuadros de texto y un botón para que los usuarios finales puedan escribir datos y agregarlos al documento. El segundo control del panel de acciones contiene un botón que abre el cuadro de diálogo Table Properties. El tercer control del panel de acciones contiene una casilla que muestra todos los controles del panel de acciones, sin tener en cuenta dónde está colocado el cursor en el documento.

Para agregar un control del panel de acciones

Seleccione el proyecto Mi panel de acciones dinámicas en el Explorador de soluciones.
En el menú Proyecto, haga clic en Agregar nuevo elemento.
En el cuadro de diálogo Agregar nuevo elemento, seleccione Control del panel de acciones, asígnele el nombre AddTextControl y haga clic en Agregar.
Cambie la propiedad Tamaño del control del recuadro de acciones a 170, 135.

Para agregar controles de formularios Windows Forms al primer control de panel de acciones

Desde la ficha Windows Forms del Cuadro de herramientas, arrastre un control Label hasta AddTextControl y cambie la propiedad Text a Para:.
Agregue un control Textbox a AddTextControl y cambie las propiedades siguientes.

Propiedad

Valor

Name

toBox

Tamaño

110, 20
Agregue un segundo control Label a AddTextControl y cambie la propiedad Text a De:.
Agregue un segundo control Textbox a AddTextControl y cambie las propiedades siguientes.

Propiedad

Valor

Name

fromBox

Tamaño

110, 20
Agregue un tercer control Label a AddTextControl bajo el cuadro de texto anterior y cambie la propiedad Text a Asunto:.
Agregue un tercer control Textbox a AddTextControl al lado de la etiqueta anterior y cambie las propiedades siguientes.

Propiedad

Valor

Name

subjectBox

Multiline

True

Tamaño

110, 40
Cambie el tamaño del cuadro de texto subjectBox para que permita incluir varias líneas.
Agregue un control Button a AddTextControl y cambie las propiedades siguientes.

Propiedad

Valor

Name

insertText

Text

Insertar

Propiedad	Valor
Name	toBox
Tamaño	110, 20

Propiedad	Valor
Name	fromBox
Tamaño	110, 20

Propiedad	Valor
Name	subjectBox
Multiline	True
Tamaño	110, 40

Propiedad	Valor
Name	insertText
Text	Insertar

Para crear el segundo control del panel de acciones

Agregue un segundo control del panel del acciones a su proyecto y asígnele el nombre ShowPropertiesControl.
Cambie la propiedad Size del control del panel de acciones a 170, 50.
Desde la ficha Windows Forms del Cuadro de herramientas, arrastre un control Button hasta ShowPropertiesControl y cambie las propiedades siguientes.

Propiedad

Valor

Name

tableProperties

Text

Propiedades de tabla

Enabled

False

Tamaño

100, 23
Para C#, cambie la propiedad Modifiers del botón a Internal.

Propiedad	Valor
Name	tableProperties
Text	Propiedades de tabla
Enabled	False
Tamaño	100, 23

Para crear el tercer control del panel de acciones

Agregue un tercer control del panel de acciones a su proyecto y asígnele el nombre ShowAllControl.
Cambie la propiedad Tamaño del control del recuadro de acciones a 170, 75.
En la pestaña Windows Forms del Cuadro de herramientas, agregue un control GroupBox a ShowAllControl y cambie la propiedad Texto a Mi recuadro de acciones.
Agregue un control CheckBox a ShowAllControl por encima del cuadro de grupo y cambie las propiedades siguientes.

Propiedad

Valor

Name

showCheck

Text

Show All Controls
Para C#, cambie la propiedad Modifiers de la casilla a Internal.

Propiedad	Valor
Name	showCheck
Text	Show All Controls

Agregar código para responder al contexto del usuario

Ahora puede escribir código para mostrar el panel de acciones y para agregar y quitar controles de panel de acciones según la ubicación del cursor en el documento. El código entra en los controladores de eventos de los controles XMLNode.

Para agregar código a eventos de control de XMLNode

En el Explorador de soluciones, haga clic con el botón secundario en ThisDocument.vb o ThisDocument.cs y, a continuación, haga clic en Ver código.

Cree una referencia variable para cada control del panel de acciones en la sección de declaraciones de ThisDocument.

Dim addText As New AddTextControl
Dim showProperties As New ShowPropertiesControl
Dim showAll As New ShowAllControl

Friend WithEvents showCheck As System.Windows.Forms.CheckBox

private AddTextControl addText = new AddTextControl();
private ShowPropertiesControl showProperties = new ShowPropertiesControl();
private ShowAllControl showAll = new ShowAllControl();

En el controlador de eventos Startup de ThisDocument, escriba el código siguiente para agregar el control ShowAllControl y mostrar el panel de acciones.
```
Me.ActionsPane.Controls.Add(showAll)
showCheck = showAll.showCheck
```
```
this.ActionsPane.Controls.Add(showAll);
```
Nota

El orden en el que se agregan los controles al panel de acciones determina su posición. Si tiene un control que siempre estará visible en la parte superior del panel de acciones, debe agregarlo en primer lugar. El orden también depende de la propiedad StackOrder del panel de acciones. Para obtener más información, vea Cómo: Administrar el diseño de controles en recuadros de acciones.

Agregue el código siguiente al controlador de eventos ContextEnter del control SampleInsertNode.

Private Sub SampleInsertNode_ContextEnter(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Word.ContextChangeEventArgs) _
    Handles SampleInsertNode.ContextEnter

    If showAll.showCheck.Checked = False Then
        Me.ActionsPane.Controls.Add(addText)
        Me.ActionsPane.Controls.Remove(showProperties)
    End If
End Sub

private void SampleInsertNode_ContextEnter(object sender,
    Microsoft.Office.Tools.Word.ContextChangeEventArgs e)
{
    if (showAll.showCheck.Checked == false)
    {
        this.ActionsPane.Controls.Add(addText);
        this.ActionsPane.Controls.Remove(showProperties);
    }
}

Agregue el código siguiente al controlador de eventos ContextLeave del control SampleInsertNode para ocultar el control después de que el usuario haya movido el cursor fuera de este nodo XML.

Private Sub SampleInsertNode_ContextLeave(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Word.ContextChangeEventArgs) _
    Handles SampleInsertNode.ContextLeave

    If showAll.showCheck.Checked = False Then
        Me.ActionsPane.Controls.Remove(addText)
    End If
End Sub

private void SampleInsertNode_ContextLeave(object sender,
    Microsoft.Office.Tools.Word.ContextChangeEventArgs e)
{
    if (showAll.showCheck.Checked == false)
    {
        this.ActionsPane.Controls.Remove(addText);
    }
}

Agregue el código siguiente al controlador de eventos ContextEnter del control SampleTableNode.

Private Sub SampleTableNode_ContextEnter(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Word.ContextChangeEventArgs) _
    Handles SampleTableNode.ContextEnter

    If showAll.showCheck.Checked = False Then
        Me.ActionsPane.Controls.Remove(addText)
        Me.ActionsPane.Controls.Add(showProperties)
    End If

    showProperties.tableProperties.Enabled = True
End Sub

private void SampleTableNode_ContextEnter(object sender,
    Microsoft.Office.Tools.Word.ContextChangeEventArgs e)
{
    if (showAll.showCheck.Checked == false)
    {
        this.ActionsPane.Controls.Remove(addText);
        this.ActionsPane.Controls.Add(showProperties);
    }
    showProperties.tableProperties.Enabled = true;
}

Agregue el código siguiente al controlador de eventos ContextLeave del control SampleTableNode para ocultar el control después de que el usuario haya movido el cursor fuera de este nodo XML.

Private Sub SampleTableNode_ContextLeave(ByVal sender As Object, _
    ByVal e As Microsoft.Office.Tools.Word.ContextChangeEventArgs) _
    Handles SampleTableNode.ContextLeave

    If showAll.showCheck.Checked = False Then
        Me.ActionsPane.Controls.Remove(showProperties)
    End If

    showProperties.tableProperties.Enabled = False
End Sub

private void SampleTableNode_ContextLeave(object sender,
    Microsoft.Office.Tools.Word.ContextChangeEventArgs e)
{
    if (showAll.showCheck.Checked == false)
    {
        this.ActionsPane.Controls.Remove(showProperties);
    }
    showProperties.tableProperties.Enabled = false;
}

En C#, debe agregar controladores de eventos para los controles XMLNode. Puede colocar este código en el controlador de eventos Startup de ThisDocument. Para obtener más información sobre cómo crear controladores de eventos, vea Cómo: Crear controladores de eventos en proyectos de Office.

this.SampleInsertNode.ContextEnter +=new Microsoft.Office.Tools.Word.
    ContextChangeEventHandler(SampleInsertNode_ContextEnter); 

this.SampleInsertNode.ContextLeave += new Microsoft.Office.Tools.Word.
    ContextChangeEventHandler(SampleInsertNode_ContextLeave);

this.SampleTableNode.ContextEnter += new Microsoft.Office.Tools.Word.
    ContextChangeEventHandler(SampleTableNode_ContextEnter);

this.SampleTableNode.ContextLeave += new Microsoft.Office.Tools.Word.
    ContextChangeEventHandler(SampleTableNode_ContextLeave);

Punto de control

Guarde su proyecto y compruebe que los controles del panel de acciones cambian a medida que desplaza el cursor por el documento.

Para probar el proyecto

Presione F5 para ejecutar el proyecto.
Lleve el punto de inserción a la palabra Para y compruebe que el control del panel de acciones addText está visible en el panel de acciones.
Coloque el punto de inserción en el interior de la tabla y compruebe que el control del panel de acciones showProperties está visible en el panel de acciones.
Coloque el punto de inserción en la palabra MEMORANDUM y compruebe que los controles de panel de acciones addText y showProperties no están visibles en el panel de acciones.

Agregar código para responder a los eventos de control en el panel de acciones

Hasta ahora, los controles del panel de acciones no hacen nada. El último paso consiste en escribir código para mostrar todos los controles, insertar texto y mostrar el cuadro de diálogo Table Properties.

Para mostrar todos los controles en el panel de acciones

Agregue el código siguiente a ThisDocument.

Private Sub showCheck_CheckStateChanged(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    Handles showCheck.CheckStateChanged

    If showAll.showCheck.Checked = True Then
        Me.ActionsPane.Controls.Add(addText)
        Me.ActionsPane.Controls.Add(showProperties)
    Else
        Me.ActionsPane.Controls.Remove(addText)
        Me.ActionsPane.Controls.Remove(showProperties)
    End If
End Sub

private void showCheck_CheckStateChanged(object sender, EventArgs e)
{
    if (showAll.showCheck.Checked)
    {
        this.ActionsPane.Controls.Add(addText);
        this.ActionsPane.Controls.Add(showProperties);
    }
    else
    {
        this.ActionsPane.Controls.Remove(addText);
        this.ActionsPane.Controls.Remove(showProperties);
    }
}

En C#, debe agregar un controlador de eventos para el control checkbox. Puede colocar este código en el controlador de eventos Startup de ThisDocument.
```
showAll.showCheck.CheckStateChanged += new EventHandler(showCheck_CheckStateChanged);
```

Para insertar texto al hacer clic en el botón Insertar

En el Explorador de soluciones, haga clic con el botón secundario en AddTextControl.vb o en AddTextControl.cs y, a continuación, haga clic en Ver código.

En el controlador de eventos Click del botón insertText, escriba el código siguiente.

Private Sub insertText_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    Handles insertText.Click

    With Globals.ThisDocument
        .InsertMemoFromNode.Text = Me.fromBox.Text
        .InsertMemoToNode.Text = Me.toBox.Text
        .InsertMemoSubjectNode.Text = Me.subjectBox.Text
    End With

    ' Clear the text boxes.
    Me.fromBox.Text = ""
    Me.toBox.Text = ""
    Me.subjectBox.Text = ""
End Sub

private void insertText_Click(object sender, System.EventArgs e)
{
    Globals.ThisDocument.InsertMemoFromNode.Text = this.fromBox.Text;
    Globals.ThisDocument.InsertMemoToNode.Text = this.toBox.Text;
    Globals.ThisDocument.InsertMemoSubjectNode.Text = this.subjectBox.Text;

    // Clear the text boxes.
    this.fromBox.Text = "";
    this.toBox.Text = "";
    this.subjectBox.Text = "";
}

En C#, debe agregar un controlador de eventos para el botón. Puede colocar este código en el constructor AddTextControl, después de la llamada a InitializeComponent.
```
public AddTextControl()
{
    InitializeComponent();
    this.insertText.Click += new System.EventHandler(this.insertText_Click);
}
```

Para mostrar el cuadro de diálogo Propiedades de tabla

En el Explorador de soluciones, haga clic con el botón secundario en ShowPropertiesControl.vb o en ShowPropertiesControl.cs y, a continuación, haga clic en Ver código.

Agregue el código siguiente al controlador de eventos Click del botón tableProperties.

Private Sub tableProperties_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    Handles tableProperties.Click

    Globals.ThisDocument.Application.Dialogs( _
        Word.WdWordDialog.wdDialogTableProperties).Show()
End Sub

private void tableProperties_Click(object sender, System.EventArgs e)
{
    object timeout = 0;

    Globals.ThisDocument.Application.Dialogs[
        Microsoft.Office.Interop.Word.WdWordDialog.wdDialogTableProperties]
            .Show(ref timeout);
}

En C#, debe agregar un controlador de eventos para el botón. Puede colocar este código en el constructor ShowPropertiesControl, después de la llamada a InitializeComponent.
```
public ShowPropertiesControl()
{
    InitializeComponent();
    this.tableProperties.Click += new System.EventHandler(this.tableProperties_Click);
}
```

Probar la aplicación

Ahora puede probar más exhaustivamente su documento para comprobar la funcionalidad de los controles del panel de acciones.

Para probar el documento

Presione F5 para ejecutar el proyecto.
Confirme que el panel de acciones está visible.
Coloque el cursor en la sección del documento que contiene las líneas Para, De y Asunto y confirme que en el panel de acciones aparecen los controles addText.
Escriba texto en los cuadros de texto Para, De y Asunto en el panel de acciones y haga clic en Insertar.
Coloque el cursor en la tabla y confirme que en el panel de acciones aparece el control showProperties.
Haga clic en el botón Propiedades de tabla y confirme que se abre el cuadro de diálogo Propiedades de tabla.
Haga clic en la casilla Mostrar todo y confirme que en el panel de acciones están visibles todos los controles.
Coloque el cursor fuera de la tabla y confirme que se deshabilita el botón Propiedades de tabla.

Pasos siguientes

Este tutorial muestra los fundamentos para cambiar el panel de acciones en función del contexto del usuario. Estas son algunas de las tareas que se pueden realizar a continuación:

Enlazar datos a controles en Word. Para obtener más información, vea Tutorial: Enlazar datos a controles en un recuadro de acciones de Word.
Enlazar datos a controles de Excel. Para obtener más información, vea Tutorial: Enlazar datos a controles en un recuadro de acciones de Excel.
Implementar el proyecto. Para obtener más información, vea Información general sobre la implementación (Implementación de Office en Visual Studio).

Vea también

Name	Dirección	Ciudad	Estado	Código postal
Nancy Davolio	507 - 20th Ave. E., Apt. 2A	Seattle	WA	98122