Bookmark.MoveUntil(Object, Object) Método

Referencia

Definición

Espacio de nombres:: Microsoft.Office.Tools.Word

Ensamblado:: Microsoft.Office.Tools.Word.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Desplaza el control Bookmark hasta que encuentra en el documento alguno de los caracteres especificados.

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

abstract member MoveUntil : obj * obj -> int

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

Parámetros

cset: Object

Uno o más caracteres. Si se encuentra algún carácter en Cset antes de que expire el Count valor, el Bookmark control se coloca como un punto de inserción inmediatamente antes de ese carácter. 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, comenzando en 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.

Devoluciones

Int32

El número de caracteres que se ha desplazado el control Bookmark. Si Count es mayor que 0 (cero), este método devuelve el número de caracteres que se ha desplazado más uno. Si Count es menor que 0 (cero), este método devuelve el número de caracteres que se ha desplazado menos uno. 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 un espacio en blanco.

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

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

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

Private Sub BookmarkMoveUntil()

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

Comentarios

Bookmark se contrae en un marcador de longitud cero.

Parámetros opcionales

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

Se aplica a

Compartir a través de