Metodo Bookmark.GoTo

Articolo
01/06/2014

Ottiene un oggetto Range che rappresenta la posizione iniziale di un elemento all'interno del controllo Bookmark.

Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Sintassi

'Dichiarazione
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
)

Parametri

What
Tipo: System.Object%
Tipo di elemento per cui viene recuperato l'oggetto Range.Può essere una delle costanti WdGoToItem.

Which
Tipo: System.Object%
Elemento per cui viene recuperato l'oggetto Range. Può essere una delle costanti WdGoToDirection.

Count
Tipo: System.Object%
Numero dell'elemento nel documento.Il valore predefinito è 1.
Sono validi solo i valori positivi.Per specificare un elemento che precede il controllo Bookmark, utilizzare wdGoToPrevious come argomento Which e specificare un valore Count.

Name
Tipo: System.Object%
Se l'argomento What è wdGoToBookmark, wdGoToComment, wdGoToField o wdGoToObject, verrà specificato un nome.

Valore restituito

Tipo: Microsoft.Office.Interop.Word.Range
Un oggetto Range.

Note

Quando si utilizza il metodo GoTo con la costante wdGoToGrammaticalError, wdGoToProofreadingError o wdGoToSpellingError, l'oggetto Range restituito includerà tutto il testo degli errori ortografici o grammaticali.

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice seguente viene inserito un controllo Bookmark con testo digitato in modo non corretto al primo paragrafo, quindi si passa al primo errore ortografico nel segnalibro e ne viene visualizzata la posizione in una finestra di messaggio.

Questo esempio è valido per una personalizzazione a livello di 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());
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

Bookmark Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Word

Condividi tramite