Bookmark.MoveStartWhile(Object, Object) Método

Definición

Espacio de nombres:

Microsoft.Office.Tools.Word

Ensamblado:

Microsoft.Office.Tools.Word.dll

Mueve la posición inicial del control Bookmark hasta que se encuentre en el documento alguno de los caracteres especificados.

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

abstract member MoveStartWhile : obj * obj -> int

Public Function MoveStartWhile (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 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 mientras puede encontrar los caracteres T, h, i o s.

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

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

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

Private Sub BookmarkMoveStartWhile()

    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.MoveStartWhile("This", Bookmark1.Characters.Count)
End Sub

Comentarios

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

Si la posición inicial se mueve hacia delante a una posición más allá de la posición final original, la posición final se establece en la nueva posición inicial.

Parámetros opcionales

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