Cómo: Actualizar el texto del marcador

Actualización: noviembre 2007

Se aplica a
La información de este tema sólo se aplica a los proyectos de Visual Studio Tools para Office y versiones de Microsoft Office especificados. Tipo de proyecto Proyectos de nivel de documento Proyectos de nivel de aplicación Versión de Microsoft Office Word 2003 Word 2007 Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto.

Puede insertar texto en un marcador de marcador de posición de un documento de Microsoft Office Word para poder recuperar el texto posteriormente o reemplazar el texto incluido en un marcador. Si está desarrollando una personalización de nivel de documento, también puede actualizar el texto de un control Microsoft.Office.Tools.Word.Bookmark que esté enlazado a datos. Para obtener más información, vea Enlazar datos a controles.

El objeto Bookmark puede ser de dos tipos:

• Un control host Microsoft.Office.Tools.Word.Bookmark.

  Los controles Microsoft.Office.Tools.Word.Bookmark amplían los objetos Microsoft.Office.Interop.Word.Bookmark nativos mediante la habilitación del enlace de datos y la exposición de eventos. Para obtener más información acerca de los controles de host, vea Información general sobre elementos y controles Host.

• Un objeto Microsoft.Office.Interop.Word.Bookmark nativo.

  Los objetos Microsoft.Office.Interop.Word.Bookmark no tienen eventos ni capacidad de enlace de datos.

Cuando se asigna texto a un marcador, el comportamiento de Microsoft.Office.Interop.Word.Bookmark y Microsoft.Office.Tools.Word.Bookmark es diferente. Para obtener más información, vea Bookmark (Control).

Utilizar controles host

Para actualizar el contenido de los marcadores usando un control Bookmark

1. Cree un procedimiento que tome un argumento bookmark para el nombre del marcador y un argumento newText para la cadena que asigna la propiedad Text.

   Nota:
   Asignar texto a las propiedades Bookmark.Text o Bookmark.FormattedText de un control Microsoft.Office.Tools.Word.Bookmark no provoca la eliminación del marcador.

   Shared Sub BookMarkReplace( _
       ByRef bookmark As Microsoft.Office.Tools.Word.Bookmark, _
       ByVal newText As String)
   

   static void BookMarkReplace(
       ref Microsoft.Office.Tools.Word.Bookmark bookmark, 
       string newText)
   {
   

2. Asigne la cadena newText a la propiedad Text del objeto Microsoft.Office.Tools.Word.Bookmark.

       bookmark.Text = newText
   End Sub
   

       bookmark.Text = newText;
   }
   

Utilizar objetos de Word

Para actualizar el contenido del marcador usando un objeto Bookmark de Word

1. Cree un procedimiento que tome un argumento bookmark para el nombre de Microsoft.Office.Interop.Word.Bookmark y un argumento newText para la cadena que asigna la propiedad Range.Text al marcador.

   Nota:
   Asignar texto a un objeto Microsoft.Office.Interop.Word.Bookmark nativo de Word causa la eliminación del marcador.

   Friend Sub BookMarkReplaceNative( _
       ByVal bookmark As Word.Bookmark, _
       ByVal newText As String)
   

   internal void BookMarkReplaceNative(
       Word.Bookmark bookmark, 
       string newText)
   {
   

2. Asigne la cadena newText a la propiedad Range.Text del marcador, que automáticamente elimina el marcador. A continuación, agregue de nuevo el marcador a la colección Bookmarks.

   El ejemplo de código siguiente se puede usar en una personalización de nivel de documento.

       Dim rng As Word.Range = bookmark.Range
       Dim bookmarkName As String = bookmark.Name
   
       bookmark.Range.Text = newText
   
       Me.Bookmarks.Add(Name:=bookmarkName, Range:=rng)
   End Sub
   

       object rng = bookmark.Range;
       string bookmarkName = bookmark.Name;
   
       bookmark.Range.Text = newText;
   
       this.Bookmarks.Add(bookmarkName, ref rng); 
   }
   

   El ejemplo de código siguiente se puede usar en un complemento de nivel de aplicación. En este ejemplo se usa el documento activo.

       Dim rng As Object = bookmark.Range
       Dim bookmarkName As String = bookmark.Name
   
       bookmark.Range.Text = newText
       Me.Application.ActiveDocument.Bookmarks.Add(Name:=bookmarkName, Range:=rng)
   End Sub
   

       object rng = bookmark.Range;
       string bookmarkName = bookmark.Name;
   
       bookmark.Range.Text = newText;
   
       Word.Document document = this.Application.ActiveDocument;
       document.Bookmarks.Add(bookmarkName, ref rng);
   }
   

Vea también

Tareas

Cómo: Insertar texto en documentos de Word

Conceptos

Información general acerca del modelo de objetos de Word

Bookmark (Control)