---
title: "Werk met Boekmerke in Java"
---


Boekmerke identifiseer in'n Microsoft Word dokument die liggings of fragmente wat jy noem en identifiseer vir toekomstige verwysing. U kan byvoorbeeld'n boekmerk gebruik om teks te identifiseer wat u later wil hersien. In plaas daarvan om deur die dokument te blaai om die teks te vind, kan jy daarheen gaan deur Die Boekmerk-dialoogkassie te gebruik.

Met Aspose.Words kan jy boekmerke in verslae of dokumente gebruik om sekere data in die boekmerk in te voeg of spesiale formatering op die inhoud daarvan toe te pas. Jy kan ook boekmerke gebruik om teks van'n sekere plek in jou dokument af te haal.

Die aksies wat uitgevoer kan word met boekmerke met behulp van Aspose.Words is dieselfde as die wat jy kan uitvoer met behulp van Microsoft Word. Jy kan'n nuwe boekmerk invoeg, uitvee, na'n boekmerk skuif, 'n boekmerknaam kry of stel, teks daarin kry of stel.

## Voeg'n Boekmerk in

Gebruik [startBookmark](https://reference.aspose.com/words/java/com.aspose.words/documentbuilder/#startBookmark-java.lang.String) en [endBookmark](https://reference.aspose.com/words/java/com.aspose.words/documentbuilder/#endBookmark-java.lang.String) om'n boekmerk te skep deur die begin en einde daarvan te merk. Moenie vergeet om dieselfde boekmerknaam aan albei metodes deur te gee nie. Boekmerke in'n dokument kan oorvleuel en enige reeks oorskry. Swak gevormde boekmerke of boekmerke met dubbele name sal geïgnoreer word wanneer die dokument gestoor word.

{{% alert color="primary" %}}

Alle wit spasies in die boekmerke is vervang met onderstrepe. Hierdie beperking kom van MS Woordformate, aangesien boekmerke in MS Woordformate, soos DOCX of DOC, nie witruimtes kan hê nie. PDF laat egter sulke boekmerke toe. So nou, as jy boekmerke in PDF, XPS of SWF buitelyne moet gebruik, kan jy dit met wit spasies gebruik.

{{% /alert %}}

Die volgende kode voorbeeld toon hoe om'n nuwe boekmerk te skep:

{{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-programming_documents-bookmarks-CreateBookmark-CreateBookmark.java" >}}

## Verkry Boekmerke

Soms is dit nodig om'n boekmerk versameling te verkry om te herhaal deur boekmerke of vir ander doeleindes. Gebruik die **Node.getRange** eienskap blootgestel deur enige dokument node wat'n **Range** voorwerp wat die gedeelte van die dokument wat in hierdie node. Gebruik hierdie voorwerp om'n **BookmarkCollection** te haal en gebruik dan die versameling indekser om'n spesifieke boekmerk te kry.

{{% alert color="primary" %}}

U kan die voorbeeldlêer van die volgende voorbeelde aflaai van [Aspose.Words GitHub](https://github.com/aspose-words/Aspose.Words-for-Java/blob/master/Examples/Data/Bookmarks.docx).

{{% /alert %}}

Die volgende kode voorbeeld toon hoe om boekmerke te verkry uit'n boekmerk versameling:

{{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-programming_documents-bookmarks-AccessBookmarks-AccessBookmarks.java" >}}

Die volgende kode voorbeeld toon hoe om te kry of stel'n boekmerk naam en teks:

{{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-programming_documents-bookmarks-BookmarkNameAndText-BookmarkNameAndText.java" >}}

Die volgende kode voorbeeld toon hoe om'n tabel te boekmerk:

{{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-programming_documents-bookmarks-BookmarkTable-BookmarkTable.java" >}}

As jy die naam van'n boekmerk verander na'n naam wat reeds in die dokument bestaan, sal geen fout gegenereer word nie en slegs die eerste boekmerk sal gestoor word wanneer jy die dokument stoor.

Let daarop dat sommige boekmerke in die dokument aan vormvelde toegeken word. As jy na so'n boekmerk beweeg en teks daar invoeg, word die teks in die vormveldkode ingevoeg. Alhoewel dit nie die vormveld ongeldig sal maak nie, sal die ingevoegde teks nie sigbaar wees nie omdat dit deel word van die veldkode.

Die volgende kode voorbeeld toon hoe om toegang te verkry kolomme van die boekmerk tabel:

{{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-programming_documents-bookmarks-BookmarkTable-BookmarkTableColumns.java" >}}

## Skuif Na'n Boekmerk

As jy ryk inhoud (nie net gewone teks) in'n boekmerk moet invoeg, moet jy [moveToBookmark](https://reference.aspose.com/words/java/com.aspose.words/documentbuilder/#moveToBookmark-java.lang.String) gebruik om die wyser na die boekmerk te skuif en dan **DocumentBuilder** metodes en eienskappe gebruik om inhoud in te voeg.

## Wys Versteek Boekmerk Inhoud

Die hele Boekmerk (*including the bookmarked content*) kan gekapsel word binne die Ware deel van die `IF` veld met behulp van Aspose.Words. Dit kan op so'n manier wees dat die `IF` veld'n geneste Samesmelting Veld in die uitdrukking (*Left of Operator*) bevat en afhangende van die waarde van Samesmelting Veld, die `IF` veld toon of verberg die inhoud van Boekmerk in Word Dokument.

Die volgende kode voorbeeld toon hoe om te wys/ verberg boekmerke.

{{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-programming_documents-bookmarks-ShowHideBookmarks-ShowHideBookmarks_call.java" >}}

{{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-programming_documents-bookmarks-ShowHideBookmarks-ShowHideBookmarks.java" >}}