Compartir a través de


Bookmark.MoveWhile (Método)

Desplaza el control Bookmark mientras se encuentra en el documento alguno de los caracteres especificados.

Espacio de nombres:  Microsoft.Office.Tools.Word
Ensamblado:  Microsoft.Office.Tools.Word (en Microsoft.Office.Tools.Word.dll)

Sintaxis

'Declaración
Function MoveWhile ( _
    ByRef cset As Object, _
    ByRef count As Object _
) As Integer
int MoveWhile(
    ref Object cset,
    ref Object count
)

Parámetros

  • cset
    Tipo: System.Object%
    Uno o más caracteres.Este argumento distingue entre mayúsculas y minúsculas.
  • count
    Tipo: System.Object%
    Número máximo de caracteres que se ha de desplazar el control Bookmark.Puede ser un número o la constante wdForward o wdBackward.Si Count es un número positivo, el control Bookmark avanza en el documento comenzando por la posición final.Si es un número negativo, el control Bookmark retrocede comenzando por la posición inicial.El valor predeterminado es wdForward.

Valor devuelto

Tipo: System.Int32
El número de caracteres que se ha desplazado el control Bookmark.Si no se encuentra ningún carácter Cset, el control Bookmark no cambia y el método devuelve 0 (cero).

Comentarios

Mientras encuentre algún carácter en Cset, el control Bookmark se desplazará.El control Bookmark se contrae a un marcador de longitud cero.

Parámetros opcionales

Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.

Ejemplos

El ejemplo de código siguiente agrega un control Bookmark con texto al primer párrafo y agrega otro control Bookmark a la tercera palabra del primer marcador.A continuación, el código se contrae y mueve el segundo marcador, siempre que encuentre los caracteres b, o, o, k.

Se trata de un ejemplo para una personalización en el nivel del documento.

Private Sub BookmarkMoveWhile()

    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")
    Bookmark1.Text = "This is sample bookmark text."

    Dim Bookmark2 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Bookmark1.Words(3), "Bookmark2")

    Bookmark2.MoveWhile("stamp", Bookmark1.Characters.Count)
End Sub
private void BookmarkMoveWhile()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
        this.Controls.AddBookmark(this.Paragraphs[1].Range,
        "bookmark1");
    bookmark1.Text = "This is sample bookmark text.";

    Microsoft.Office.Tools.Word.Bookmark bookmark2 =
        this.Controls.AddBookmark(bookmark1.Words[3],
        "bookmark2");

    object Count = bookmark1.Characters.Count;
    object cSet = "book";

    bookmark2.MoveWhile(ref cSet, ref Count);
}

Seguridad de .NET Framework

Vea también

Referencia

Bookmark Interfaz

Microsoft.Office.Tools.Word (Espacio de nombres)