Navigation mit Cursor
Während Sie mit einem Dokument arbeiten, auch wenn es sich um ein kurzes oder langes Dokument handelt, 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 Verschieben in einem Dokument einfach, da Sie die Einfügemarke sogar mithilfe der Pfeiltasten der Tastatur oder durch Klicken mit der Maus verschieben können, um die Einfügemarke an einer beliebigen Stelle zu finden. Sobald Sie jedoch ein großes Dokument mit vielen Seiten haben, reichen diese grundlegenden Techniken nicht mehr aus.
In diesem Artikel wird erläutert, wie Sie sich in einem Dokument bewegen und mit einem virtuellen Cursor zu verschiedenen Teilen des Dokuments navigieren.
Aktuelle Cursorposition erkennen
Bevor Sie mit dem Navigieren durch Ihr Dokument beginnen, müssen Sie den aktuell ausgewählten Knoten abrufen. Sie können die genaue Position des Cursors an einem ausgewählten Knoten mithilfe der Eigenschaft CurrentNode ermitteln. Außerdem können Sie anstelle des aktuellen Knotens den aktuell ausgewählten Absatz oder den aktuell ausgewählten Abschnitt mithilfe der Eigenschaften CurrentParagraph und CurrentSection 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 CurrentNode nullptr zurück.
Navigationsmethoden in einem Dokument
Wenn Sie Text bearbeiten, ist es wichtig zu wissen, wie Sie in Ihrem Dokument navigieren und wo genau 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 verschieben zu können. Dies können Sie mit der Methode MoveTo erreichen.
Das folgende Codebeispiel zeigt, wie Sie die DocumentBuilder zu verschiedenen Knoten in einem Dokument verschieben:
Neben der grundlegenden MoveTo -Methode gibt es jedoch spezifischere.
Zum Anfang oder Ende eines Dokuments navigieren
Sie können mit den Methoden MoveToDocumentStart und MoveToDocumentEnd zum Anfang oder zum Ende Ihres Dokuments wechseln.
Das folgende Codebeispiel zeigt, wie Sie die Cursorposition an den Anfang oder das Ende eines Dokuments verschieben:
Navigieren mit Lesezeichen
Sie können einen Ort markieren, den Sie finden möchten, und ihn einfach wieder aufrufen. Sie können beliebig viele Lesezeichen in Ihr Dokument einfügen und dann durch sie navigieren, indem Sie die Lesezeichen mit eindeutigen Namen identifizieren. Sie können zu einem Lesezeichen wechseln, indem Sie die MoveToBookmark -Methode verwenden.
Die folgenden Codebeispiele zeigen, wie Sie eine Cursorposition auf ein Lesezeichen verschieben:
Zu Tabellenzellen navigieren
Sie können zu einer Tabellenzelle wechseln, indem Sie die MoveToCell-Methode verwenden. Mit dieser Methode können Sie mit dem Cursor in eine beliebige Zelle in 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:
Zu einem Feld navigieren
Sie können zu einem bestimmten Feld in Ihrem Dokument wechseln, indem Sie die MoveToField -Methode verwenden. Außerdem können Sie mit der MoveToMergeField-Methode zu einem bestimmten Seriendruckfeld wechseln.
Das folgende Codebeispiel zeigt, wie Sie den Cursor des Dokumentgenerators auf ein bestimmtes Feld bewegen:
Navigieren zu einer Kopf- oder Fußzeile
Sie können zum Anfang einer Kopf- oder Fußzeile wechseln, indem Sie die MoveToHeaderFooter-Methode verwenden.
Das folgende Codebeispiel zeigt, wie Sie den Cursor des Dokumentgenerators auf eine Kopf- oder Fußzeile eines Dokuments bewegen:
Navigieren zu einem Abschnitt oder Absatz
Sie können zu einem bestimmten Abschnitt oder Absatz wechseln, indem Sie die Methoden MoveToParagraph oder MoveToSection verwenden. 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: