Bookmark.MoveWhile(Object, Object) Método

Referência

Definição

Namespace:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Move o controle Bookmark enquanto qualquer um dos caracteres especificados é localizado no documento.

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

abstract member MoveWhile : obj * obj -> int

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

Parâmetros

cset: Object

Um ou mais caracteres. Este argumento diferencia maiúsculas de minúsculas.

count: Object

O número máximo de caracteres em que o controle Bookmark deve ser movido. Pode ser um número ou a constante wdForward ou wdBackward. Se Count for um número positivo, o Bookmark controle será movido para frente no documento, começando na posição final. Caso seja um número negativo, o controle Bookmark será recuado, começando na posição inicial. O valor padrão é wdForward.

Retornos

Int32

O número de caracteres pelos quais o controle Bookmark foi movido. Caso nenhum caractere Cset seja encontrado, o controle Bookmark não é alterado e o método retorna 0 (zero).

Exemplos

O exemplo de código a seguir adiciona um controle Bookmark com texto ao primeiro parágrafo e, em seguida, adiciona outro controle Bookmark à terceira palavra no primeiro indicador. Em seguida, o código recolhe e move o segundo indicador enquanto pode encontrar os caracteres b, o, o ou k.

Este exemplo destina-se a uma personalização no nível de documento.

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

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

Private Sub BookmarkMoveWhile()

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

Comentários

Enquanto qualquer caractere em Cset é encontrado, o Bookmark controle é movido. O Bookmark é recolhido a um indicador de comprimento zero.

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Aplica-se a

Compartilhar via