Bookmark.GoTo-Methode

Artikel
08/10/2011

Ruft ein Range-Objekt ab, das die Anfangsposition eines Elements im Bookmark-Steuerelement darstellt.

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

Syntax

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

Parameter

What
Typ: System.Object%
Die Art des Elements, für die der Range abgerufen wird.Kann eine der WdGoToItem-Konstanten sein.

Which
Typ: System.Object%
Das Element, für das der Range abgerufen wird, kann eine der WdGoToDirection-Konstanten sein.

Count
Typ: System.Object%
Die Anzahl der Elemente im Dokument.Der Standardwert ist 1.
Nur positive Werte sind gültig.Verwenden Sie wdGoToPrevious als Which-Argument, und geben Sie einen Count-Wert an, um ein Element anzugeben, das dem Bookmark-Steuerelement vorangestellt ist.

Name
Typ: System.Object%
Wenn das What-Argument auf wdGoToBookmark, wdGoToComment, wdGoToField oder wdGoToObject festgelegt wurde, gibt dieses Argument einen Namen an.

Rückgabewert

Typ: Microsoft.Office.Interop.Word.Range
Ein Range-Objekt.

Hinweise

Wenn Sie die GoTo-Methode mit einer der Konstanten wdGoToGrammaticalError, wdGoToProofreadingError oder wdGoToSpellingError verwenden, schließt der zurückgegebene Range alle Texte mit Rechtschreib- und Grammatikfehlern ein.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird in den ersten Absatz ein Bookmark-Steuerelement mit falsch geschriebenem Text eingefügt. Anschließend wird die Position des ersten Rechtschreibfehlers im Lesezeichen in einem Meldungsfeld angezeigt.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

Bookmark Schnittstelle

Microsoft.Office.Tools.Word-Namespace

Freigeben über