Bookmark.MoveEndWhile(Object, Object) Método

Definición

Espacio de nombres:

Microsoft.Office.Tools.Word

Ensamblado:

Microsoft.Office.Tools.Word.dll

Mueve la posición del carácter final de un control Bookmark mientras se encuentra cualquiera de los caracteres especificados en el documento.

public int MoveEndWhile (ref object cset, ref object count);

abstract member MoveEndWhile : obj * obj -> int

Public Function MoveEndWhile (ByRef cset As Object, Optional ByRef count As Object) As Integer

Parámetros

cset

Object

Uno o más caracteres. Este argumento distingue entre mayúsculas y minúsculas.

count

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 Bookmark control se mueve hacia delante en el documento. Si es un número negativo, el control Bookmark retrocede. El valor predeterminado es wdForward.

Devoluciones

Int32

El número de caracteres que se ha desplazado la posición final del control Bookmark. Si no se encuentra ningún carácter Cset, el control Bookmark no cambia y el método devuelve 0 (cero).

Ejemplos

En el ejemplo de código siguiente se agrega un Bookmark control con texto al primer párrafo y, a continuación, se agrega otro Bookmark control a la tercera palabra del primer marcador. A continuación, el código mueve el intervalo del segundo marcador mientras puede encontrar los caracteres b, o, o, k, m, a, r o k.

Este ejemplo es para una personalización de nivel de documento.

private void BookmarkMoveEndWhile()
{
    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 = "bookmark";

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

Private Sub BookmarkMoveEndWhile()
    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.MoveEndWhile("bookmark", Bookmark1.Characters.Count)
End Sub

Comentarios

Mientras se encuentra cualquier carácter de Cset , se mueve la posición final del Bookmark control.

Si la posición final se mueve hacia atrás a un punto que precede a la posición inicial original, la posición inicial se establece en la nueva posición final.

Parámetros opcionales

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