Navigation mit Cursor

Während Sie mit einem Dokument arbeiten, auch wenn es kurz oder lang ist, müssen Sie durch Ihr Dokument navigieren. Die Navigation mit einem virtuellen Cursor stellt die Möglichkeit dar, zwischen verschiedenen Knoten in einem Dokument zu navigieren.

Innerhalb eines kurzen Dokuments ist das Bewegen innerhalb eines Dokuments einfach, da Sie die Einfügemarke sogar verschieben können, indem Sie die Pfeiltasten der Tastatur verwenden oder mit der Maus klicken, um die Einfügemarke an die gewünschte Stelle zu setzen. Sobald Sie jedoch ein großes Dokument mit vielen Seiten haben, werden diese grundlegenden Techniken nicht mehr ausreichen.

In diesem Artikel wird erklärt, wie Sie sich in einem Dokument bewegen und mit einem virtuellen Cursor zu verschiedenen Teilen davon navigieren.

Erkennen der aktuellen Cursorposition

Bevor Sie mit der Navigation durch Ihr Dokument beginnen, müssen Sie den aktuell ausgewählten Knoten abrufen. Mithilfe der CurrentNode-Eigenschaft können Sie die genaue Position des Cursors an einem ausgewählten Knoten ermitteln. Anstatt den aktuellen Knoten abzurufen, können Sie außerdem den aktuell ausgewählten Absatz oder den aktuell ausgewählten Abschnitt mithilfe der CurrentParagraph- und CurrentSection-Eigenschaften abrufen.

Alle Einfügevorgänge, die Sie mit DocumentBuilder ausführen, werden vor CurrentNode eingefügt. Wenn der aktuelle Absatz leer ist oder der Cursor kurz vor dem Ende des Absatzes positioniert ist, gibt das CurrentNode null zurück.

Wenn Sie Text bearbeiten, ist es wichtig zu wissen, wie Sie in Ihrem Dokument navigieren und wohin Sie sich darin bewegen müssen. Aspose.Words ermöglicht es Ihnen, sich in einem Dokument zu bewegen und zu seinen verschiedenen Abschnitten und Teilen zu navigieren – dies ähnelt der Funktionalität des Navigationsbereichs in Microsoft Word, um zu einer Seite oder Überschrift in einem Word-Dokument zu gelangen, ohne zu scrollen.

Die Hauptmethode besteht darin, die Cursorposition auf einen bestimmten Knoten in Ihrem Dokument zu verschieben. Dies können Sie mithilfe der MoveTo-Methode erreichen.

Das folgende Codebeispiel zeigt, wie das DocumentBuilder auf verschiedene Knoten in einem Dokument verschoben wird:

Aber neben der grundlegenden MoveTo-Methode gibt es noch spezifischere.

Sie können mit den Methoden MoveToDocumentStart und MoveToDocumentEnd zum Anfang oder Ende Ihres Dokuments springen.

Das folgende Codebeispiel zeigt, wie Sie die Cursorposition an den Anfang oder das Ende eines Dokuments verschieben:

Sie können einen Ort, den Sie suchen möchten, markieren und problemlos wieder dorthin wechseln. Sie können beliebig viele Lesezeichen in Ihr Dokument einfügen und dann durch diese navigieren, indem Sie den Lesezeichen eindeutige Namen geben. Sie können mit der MoveToBookmark-Methode zu einem Lesezeichen wechseln.

Die folgenden Codebeispiele zeigen, wie Sie eine Cursorposition zu einem Lesezeichen verschieben:

Mit der MoveToCell-Methode können Sie zu einer Tabellenzelle wechseln. Mit dieser Methode können Sie Ihren Cursor in eine beliebige Zelle einer bestimmten Tabelle navigieren. Darüber hinaus können Sie einen Index angeben, um den Cursor an eine beliebige Position oder ein bestimmtes Zeichen in einer Zelle innerhalb der MoveToCell-Methode zu bewegen.

Das folgende Codebeispiel zeigt, wie eine Cursorposition in eine angegebene Tabellenzelle verschoben wird:

Mithilfe der MoveToField-Methode können Sie zu einem bestimmten Feld in Ihrem Dokument wechseln. Darüber hinaus können Sie mithilfe der MoveToMergeField-Methode zu einem bestimmten Zusammenführungsfeld wechseln.

Das folgende Codebeispiel zeigt, wie der Document Builder-Cursor auf ein bestimmtes Feld verschoben wird:

Navigieren Sie zu einer Kopf- oder Fußzeile

Mit der MoveToHeaderFooter-Methode können Sie zum Anfang einer Kopf- oder Fußzeile wechseln

Das folgende Codebeispiel zeigt, wie der Document Builder-Cursor in die Kopf- oder Fußzeile eines Dokuments verschoben wird:

Mit den Methoden MoveToParagraph oder MoveToSection können Sie zu einem bestimmten Abschnitt oder Absatz wechseln. Darüber hinaus können Sie einen Index angeben, um den Cursor an eine beliebige Position oder ein bestimmtes Zeichen in einem Absatz innerhalb der MoveToParagraph-Methode zu bewegen.

Das folgende Codebeispiel zeigt, wie Sie zu einem bestimmten Abschnitt und einem bestimmten Absatz in einem Dokument wechseln: