Bookmark.MoveStart(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 a posição inicial do controle Bookmark.

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

abstract member MoveStart : obj * obj -> int

Public Function MoveStart (Optional ByRef unit As Object, Optional ByRef count As Object) As Integer

Parâmetros

unit: Object

Microsoft.Office.Interop.Word.WdUnits. A unidade pela qual a posição inicial do intervalo especificado ou a seleção será movida.

count: Object

O número máximo de unidades pelo qual o controle Bookmark deve ser movido. Se Count for um número positivo, a posição inicial do Bookmark controle será movida para frente no documento. Se esse for um número negativo, a posição inicial será recuada. Se a posição inicial for movida para frente até uma posição além da posição final, o controle Bookmark será recolhido e as posições inicial e final serão movidas juntas. O valor padrão é 1.

Retornos

Int32

O número de unidades que a posição inicial do 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, em seguida, move a posição inicial do indicador.

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

private void BookmarkMoveStart()
{
    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.wdCharacter;
    object Count = 3;

    bookmark1.MoveStart(ref Unit, ref Count);
                
}

Private Sub BookmarkMoveStart()

    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("First word of bookmark prior to calling MoveStart: " _
        & Bookmark1.Words.First.Text)

    Bookmark1.MoveStart(Word.WdUnits.wdCharacter, 4)
    
    MessageBox.Show("First word of bookmark prior to calling MoveStart: " _
        & Bookmark1.Words.First.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

Compartilhar via