Método Bookmark.GoTo

Artigo
08/01/2011

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

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.dll)

Sintaxe

'Declaração
Function GoTo ( _
    ByRef What As Object, _
    ByRef Which As Object, _
    ByRef Count As Object, _
    ByRef Name As Object _
) As Range

Range GoTo(
    ref Object What,
    ref Object Which,
    ref Object Count,
    ref Object Name
)

Parâmetros

What
Tipo: System.Object%
O tipo de item para o qual o Range é recuperado.Pode ser uma da WdGoToItem constantes.

Which
Tipo: System.Object%
O item para o qual o Range é recuperado pode ser uma da WdGoToDirection constantes.

Count
Tipo: System.Object%
O número do item no documento.O valor padrão é 1.
Apenas 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
Tipo: System.Object%
Se o What argumento é wdGoToBookmark, wdGoToComment, wdGoToField, ou wdGoToObject, esse argumento especifica um nome.

Valor de retorno

Tipo: Microsoft.Office.Interop.Word.Range
A Range objeto.

Comentários

Quando você usa o GoTo método com o wdGoToGrammaticalError, wdGoToProofreadingError, ou wdGoToSpellingError constante, a Range que é retornado inclui qualquer texto de erro de gramática ou texto de erro de ortografia.

Optional Parameters

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

Exemplos

O seguinte código exemplo insere uma Bookmark controle de texto com ortografia incorreta ao primeiro parágrafo e vai para o primeiro erro de ortografia no indicador e exibe sua posição em uma caixa de mensagem.

Este exemplo é para uma personalização em nível de documento.

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

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());
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

Bookmark Interface

Namespace Microsoft.Office.Tools.Word

Compartilhar via