Bookmark.GoTo(Object, Object, 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.

Obtém um objeto Range que representa a posição inicial de um item dentro do controle Bookmark.

public Microsoft.Office.Interop.Word.Range GoTo (ref object What, ref object Which, ref object Count, ref object Name);

abstract member GoTo : obj * obj * obj * obj -> Microsoft.Office.Interop.Word.Range

Public Function GoTo (Optional ByRef What As Object, Optional ByRef Which As Object, Optional ByRef Count As Object, Optional ByRef Name As Object) As Range

Parâmetros

What: Object

O tipo de item para o qual o Range é recuperado. Pode ser uma das constantes WdGoToItem.

Which: Object

O item para o qual o Range é recuperado pode ser uma das constantes WdGoToDirection.

Count: Object

O número do item no documento. O valor padrão é 1. Somente valores positivos são válidos. Para especificar um item que precede o Bookmark controle, use wdGoToPrevious como o Which argumento e especifique um Count valor.

Name: Object

Se o What argumento for wdGoToBookmark, wdGoToComment, wdGoToFieldou wdGoToObject, esse argumento especificará um nome.

Retornos

Range

Um objeto Range.

Exemplos

O exemplo de código a seguir insere um Bookmark controle com texto escrito incorretamente no primeiro parágrafo e, em seguida, vai para o primeiro erro de ortografia no indicador e exibe sua posição em uma caixa de mensagem.

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

private void BookmarkGoTo()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
       this.Controls.AddBookmark(this.Paragraphs[1].Range,
       "bookmark1");
    bookmark1.Text = "This bookmark contains spellling erors.";

    object What = Word.WdGoToItem.wdGoToSpellingError;
    object Which = Word.WdGoToDirection.wdGoToFirst;
    
    Word.Range range1 = bookmark1.GoTo(ref What, ref Which, ref missing, 
        ref missing);

    MessageBox.Show("The first spelling error in bookmark1 is at position " 
        + range1.Start.ToString());
}

Private Sub BookmarkGoTo()

    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")
    Bookmark1.Text = "This bookmark contains spellling erors."

    Dim Range1 As Word.Range = Bookmark1.GoTo( _
        What:=Word.WdGoToItem.wdGoToSpellingError, _
        Which:=Word.WdGoToDirection.wdGoToFirst)

    MessageBox.Show("The first spelling error in Bookmark1 " & _
        "is at position " & Range1.Start.ToString)

End Sub

Comentários

Quando você usa o GoTo método com a wdGoToGrammaticalErrorconstante , wdGoToProofreadingErrorou wdGoToSpellingError , o Range retornado inclui qualquer texto de erro gramatical ou texto de erro ortográfico.

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