Bookmark.MoveEndUntil(Object, Object) Método

Definición

Espacio de nombres:

Microsoft.Office.Tools.Word

Ensamblado:

Microsoft.Office.Tools.Word.dll

Mueve la posición final del control Bookmark hasta que se encuentra en el documento cualquiera de los caracteres especificados.

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

abstract member MoveEndUntil : obj * obj -> int

Public Function MoveEndUntil (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 Count es mayor que 0 (cero), este método devuelve el número de caracteres que se ha desplazado más 1. Si Count es menor que 0 (cero), este método devuelve el número de caracteres que se ha desplazado menos 1. 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 hasta que encuentra el carácter k.

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

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

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

Private Sub BookmarkMoveEndUntil()
    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.MoveEndUntil("k", Bookmark1.Characters.Count)
End Sub

Comentarios

Si el movimiento está hacia delante en el documento, el Bookmark control se expande.

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.