Bookmark.MoveStartUntil(Object, Object) Método

  • Referência

Definição

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

Move a posição inicial do controle Bookmark até um dos caracteres especificados ser localizado no 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

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. Caso seja um número negativo, o controle Bookmark é recuado. O valor padrão é wdForward.

Retornos

Int32

O número de caracteres movidos pela posição inicial do controle Bookmark. Se Count for maior que 0 (zero), esse método retornará o número de caracteres movidos mais 1. Se Count for menor que 0 (zero), esse método retornará o número de caracteres movidos menos 1. 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 Bookmark controle com texto ao primeiro parágrafo e move o intervalo do indicador até encontrar um espaço.

Este exemplo destina-se a uma personalização no nível 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

Comentários

Se o movimento for retrógrado por meio do documento, o Bookmark controle será expandido.

Se a posição inicial for movida para um ponto além da posição final, o Bookmark controle será recolhido e as posições inicial e final serão movidas juntas.

Parâmetros Opcionais

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

Aplica-se a