Método Bookmark.GoTo

Artigo
05/21/2013

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

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 que Range é recuperado.Pode ser uma das constantes de WdGoToItem .

Which
Tipo: System.Object%
O item que Range é recuperado pode ser uma das constantes de WdGoToDirection .

Count
Tipo: System.Object%
O número de itens no documento.O valor padrão é 1.
Somente os valores positivos são válidos.Para especificar um item que preceda o controle de Bookmark , use wdGoToPrevious como o argumento de Which e especifique um valor de Count .

Name
Tipo: System.Object%
Se o argumento de What é wdGoToBookmark, wdGoToComment, wdGoToField, ou wdGoToObject, esse argumento especifica um nome.

Valor de retorno

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

Comentários

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

Parâmetros Opcionais

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

Exemplos

O exemplo de código insere um controle de Bookmark com texto digitado para o primeiro parágrafo então vá para o primeiro erro de ortografia no indexador e exibe sua posição em uma caixa de mensagem.

Este exemplo é para uma personalização da nível.

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