Bookmark.MoveEnd(Object, Object) Método

Definição

Move a posição do caractere final de um controle Bookmark.

public int MoveEnd (ref object unit, ref object count);

Parâmetros

unit
Object

A unidade pela qual mover a posição do caractere final.

count
Object

O número de unidades a serem movidas. Se esse número for positivo, a posição do caractere final será movida para frente no documento. Se esse número for negativo, o final será movido para trás. Se a posição final ultrapassar a posição inicial, o intervalo será recolhido e as duas posições de caractere serão movidas juntas. O valor padrão é 1.

Retornos

Int32

O número de unidades que o controle Bookmark realmente moveu ou retornará 0 (zero) se a movimentação não tiver sido bem-sucedida.

Exemplos

O exemplo de código a seguir adiciona um Bookmark controle com texto ao primeiro parágrafo e exibe a última palavra do indicador em uma caixa de mensagem. Em seguida, o código chama o MoveEnd método e exibe a última palavra do indicador em uma nova caixa de mensagem.

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

private void BookmarkMoveEnd()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    this.Paragraphs[1].Range.Text = "This is sample text.";
    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
        this.Controls.AddBookmark(this.Paragraphs[1].Range.Words[3],
        "bookmark1");
    
    object Unit = Word.WdUnits.wdWord;
    object Count = 1;

    MessageBox.Show("Last word of bookmark prior to calling MoveEnd: "
        + bookmark1.Words.Last.Text);

    bookmark1.MoveEnd(ref Unit, ref Count);

    MessageBox.Show("Last word of bookmark after calling MoveEnd: "
        + bookmark1.Words.Last.Text);

}
Private Sub BookmarkMoveEnd()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.Text = "This is sample text."
    Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Me.Paragraphs(1).Range.Words(3), _
        "Bookmark1")

    MessageBox.Show("Last word of bookmark prior to calling MoveEnd: " _
        & Bookmark1.Words.Last.Text)

    Bookmark1.MoveEnd(Word.WdUnits.wdWord, 1)
    
    MessageBox.Show("Last word of bookmark after calling MoveEnd: " _
        & Bookmark1.Words.Last.Text)
End Sub

Comentários

Parâmetros opcionais

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

Aplica-se a