Werken met bladwijzers
Bladwijzers identificeren in een Microsoft Word documenteer de locaties of fragmenten die u noemt en identificeert voor toekomstige referentie. U kunt bijvoorbeeld een bladwijzer gebruiken om tekst te identificeren die u later wilt herzien. In plaats van door het document te schuiven om de tekst te lokaliseren, kunt u naar het bladwijzervenster gaan.
De acties die kunnen worden uitgevoerd met bladwijzers met behulp van Aspose.Words zijn dezelfde als degenen die u kunt uitvoeren met behulp van Microsoft Word. U kunt een nieuwe bladwijzer invoegen, verwijderen, verplaatsen naar een bladwijzer, een bladwijzernaam krijgen of instellen, tekst insluiten of instellen.
Bladwijzer invoegen
Gebruik StartBookmark en EndBookmark om een bladwijzer aan te maken door het begin en het einde ervan te markeren. Vergeet niet dezelfde bladwijzernaam aan beide methoden door te geven. Bladwijzers in een document kunnen elk bereik overlappen. Slecht gevormde bladwijzers of bladwijzers met dubbele namen worden genegeerd wanneer het document wordt opgeslagen.
Het volgende voorbeeld van code laat zien hoe je een nieuwe bladwijzer aanmaakt:
Bladwijzers verkrijgen
Soms is het noodzakelijk om een bladwijzercollectie te verkrijgen om te itereren via bladwijzers of voor andere doeleinden. Gebruik de Node.Range eigenschap blootgesteld door een document knooppunt dat een Range object dat het gedeelte van het document in deze node vertegenwoordigt. Gebruik dit object om een BookmarkCollection en gebruik dan de collectie indexer om een specifieke bladwijzer te krijgen.
Het volgende voorbeeld van code laat zien hoe u bladwijzers kunt verkrijgen uit een bladwijzercollectie:
Het volgende voorbeeld van code laat zien hoe u een bladwijzernaam en -tekst kunt verkrijgen of instellen:
Het volgende codevoorbeeld laat zien hoe u een tabel bladwijzer kunt maken:
Als u de naam van een bladwijzer verandert in een naam die al bestaat in het document, zal er geen fout worden gegenereerd en alleen de eerste bladwijzer wordt opgeslagen wanneer u het document opslaat.
Merk op dat sommige bladwijzers in het document worden toegewezen aan formuliervelden. Door naar zo’n bladwijzer te gaan en tekst in te voegen wordt de tekst in het formulierveld ingevoerd. Hoewel dit het formulierveld niet ongeldig maakt, zal de ingevoegde tekst niet zichtbaar zijn omdat het deel wordt van de veldcode.
Het volgende voorbeeld van code laat zien hoe je de kolommen van de bladwijzertabel kunt benaderen:
Naar een bladwijzer verplaatsen
Als je rijke inhoud (niet alleen gewone tekst) in een bladwijzer moet invoegen, moet je deze gebruiken MoveToBookmark om de cursor naar de bladwijzer te verplaatsen en vervolgens te gebruiken DocumentBuilder’s methoden en eigenschappen om inhoud in te voegen.
Bladwijzerinhoud tonen
De gehele bladwijzer (met inbegrip van de bladwijzer) kan worden ingekapseld in het ware deel van de IF veld gebruiken Aspose.Words. Het kan zo zijn dat de IF veld bevat een geneste Samenvoegveld in de expressie (Links van Operator) en afhankelijk van de waarde van Samenvoegveld, de IF veld toont of verbergt de inhoud van bladwijzer in Word Document.
Het volgende codevoorbeeld laat zien hoe bladwijzers getoond/verbergen: