Bookmark.MoveStartUntil(Object, Object) Método

Definición

Espacio de nombres:

Microsoft.Office.Tools.Word

Ensamblado:

Microsoft.Office.Tools.Word.dll

Desplaza la posición inicial del control Bookmark hasta que encuentra uno de los caracteres especificados en el documento.

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

abstract member MoveStartUntil : obj * obj -> int

Public Function MoveStartUntil (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 inicial 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 mueve el intervalo del marcador hasta que encuentra un espacio.

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

private void BookmarkMoveStartUntil()
{
    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.";
 
    object Count = bookmark1.Characters.Count;
    object cSet = " ";

    bookmark1.MoveStartUntil(ref cSet, ref Count);
}

Private Sub BookmarkMoveStartUntil()

    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."

    Bookmark1.MoveStartUntil(" ", Bookmark1.Characters.Count)
End Sub

Comentarios

Si el movimiento está hacia atrás a través del documento, el Bookmark control se expande.

Si la posición inicial se mueve hacia delante a un punto más allá de la posición final, el Bookmark control se contrae y las posiciones inicial y final se mueven juntas.

Parámetros opcionales

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