Navigatie met Cursor
Tijdens het werken met een document, zelfs als het een kort of lang document is, moet u door uw document navigeren. Navigatie met een virtuele cursor vertegenwoordigt de mogelijkheid om te navigeren tussen verschillende knooppunten in een document.
Binnen een kort document is het verplaatsen in een document eenvoudig, omdat u de invoegpositie kunt verplaatsen, zelfs met behulp van de pijltoetsen van het toetsenbord of door met de muis te klikken om de invoegpositie te vinden waar u maar wilt. Maar als je eenmaal een groot document hebt dat veel pagina ' s heeft, zullen deze basistechnieken onvoldoende zijn.
In dit artikel wordt uitgelegd hoe u zich in een document kunt verplaatsen en met een virtuele cursor naar verschillende delen ervan kunt navigeren.
Huidige Cursorpositie Detecteren
Voordat u begint met het navigeren door uw document, moet u het knooppunt ophalen dat momenteel is geselecteerd. U kunt de exacte positie van de cursor op een geselecteerd knooppunt krijgen door de eigenschap CurrentNode te gebruiken. In plaats van het huidige knooppunt te krijgen, kunt u bovendien de momenteel geselecteerde alinea of de momenteel geselecteerde sectie ophalen met behulp van de eigenschappen CurrentParagraph en CurrentSection.
Alle insert-bewerkingen die u uitvoert met de DocumentBuilder worden ingevoegd vóór de CurrentNode. Wanneer de huidige alinea leeg is of de cursor vlak voor het einde van de alinea staat, geeft de CurrentNode nullptr terug.
Navigeren in een Document
Wanneer u tekst bewerkt, is het belangrijk om te weten hoe u door uw document moet navigeren en waar u zich precies in het document moet verplaatsen. Met Aspose.Words kunt u zich verplaatsen in een document en naar de verschillende secties en onderdelen navigeren – Dit is vergelijkbaar met de functionaliteit van het navigatiedeelvenster in Microsoft Word om naar een pagina of kop in een Word document te gaan zonder te scrollen.
De belangrijkste methode is om de cursorpositie te kunnen verplaatsen naar een specifiek knooppunt in uw document, u kunt dit bereiken door de methode MoveTo te gebruiken.
Het volgende codevoorbeeld laat zien hoe de DocumentBuilder naar verschillende knooppunten in een document moet worden verplaatst:
Maar naast de basismethode MoveTo zijn er meer specifieke.
Naar het begin of einde van een Document navigeren
U kunt naar het begin of het einde van uw document gaan met de methoden MoveToDocumentStart en MoveToDocumentEnd.
Het volgende codevoorbeeld laat zien hoe u de cursorpositie naar het begin of het einde van een document verplaatst:
Navigeren Met Bladwijzers
U kunt een plaats markeren die u wilt vinden en er gemakkelijk weer naartoe verhuizen. U kunt zoveel bladwijzers in uw document invoegen als u wilt en er vervolgens doorheen navigeren door de bladwijzers met unieke namen te identificeren. U kunt naar een bladwijzer gaan met de methode MoveToBookmark.
De volgende codevoorbeelden laten zien hoe u een cursorpositie naar een bladwijzer verplaatst:
Navigeer naar tabelcellen
U kunt naar een tabelcel gaan met de methode MoveToCell. Met deze methode kunt u met uw cursor naar een cel in een specifieke tabel navigeren. Bovendien kunt u een index opgeven om de cursor naar een willekeurige positie of opgegeven teken in een cel binnen de methode MoveToCell te verplaatsen.
Het volgende codevoorbeeld toont hoe u een cursorpositie naar een opgegeven tabelcel verplaatst:
Naar een veld navigeren
U kunt naar een specifiek veld in uw document gaan met de methode MoveToField. Bovendien kunt u naar een specifiek samenvoegveld gaan met de methode MoveToMergeField.
Het volgende codevoorbeeld laat zien hoe u de Document builder-cursor naar een specifiek veld verplaatst:
Naar een kop-of voettekst navigeren
U kunt naar het begin van een kop-of voettekst gaan met de methode MoveToHeaderFooter.
Het volgende codevoorbeeld laat zien hoe u de cursor van document builder verplaatst naar een kop-of voettekst van een document:
Naar een sectie of alinea navigeren
U kunt naar een specifieke sectie of alinea gaan met behulp van de methoden MoveToParagraph of MoveToSection. Bovendien kunt u een index opgeven om de cursor naar een willekeurige positie of een opgegeven teken in een alinea binnen de methode MoveToParagraph te verplaatsen.
Het volgende codevoorbeeld toont hoe u naar een specifieke sectie en een specifieke alinea in een document kunt gaan: