Adds a bookmark pointing to the current page.

[C#]
virtual int AddBookmark(string path, bool open)

[Visual Basic]
Overridable Function AddBookmark(path As String, open As Boolean) As Integer


Adds a bookmark which points to the current page.

Bookmarks are specified as paths in much the same way as file paths. Headings and subheadings are separated by a backslash character. For example:

"1. Introduction\1.1 Aim and Methods\1.1.3 Diagrams"

When a bookmark is added, intermediate headings and subheadings will be created if they do not already exist.

To add multiple bookmarks all referring to the same page simply call the AddBookmark function multiple times.

This function returns the Object ID of the newly added Bookmark Object.

The following code adds a sequence of pages with a nested sequence of bookmarks. The image shows the appearance of the document outline. Note that none of the subject pages are visible because the chapter pages were added in a collapsed state.

[C#]
Doc theDoc = new Doc();
theDoc.FontSize = 64;
string theSection, theChapter, theSubject;
for (int i = 1; i < 3; i++) {
  theDoc.Page = theDoc.AddPage();
  theSection = i.ToString() + " Section";
  theDoc.AddText(theSection);
  theDoc.AddBookmark(theSection, true);
  for (int j = 1; j < 5; j++) {
    theDoc.Page = theDoc.AddPage();
    theChapter = theSection + "\\" + j.ToString() + " Chapter";
    theDoc.AddText(theChapter);
    theDoc.AddBookmark(theChapter, false);
    for (int k = 1; k < 6; k++) {
      theDoc.Page = theDoc.AddPage();
      theSubject = theChapter + "\\" + k.ToString() + " Subject";
      theDoc.AddText(theSubject);
      theDoc.AddBookmark(theSubject, true);
    }
  }
}
theDoc.Save(Server.MapPath("docaddbookmark.pdf"));
theDoc.Clear();

[Visual Basic]
Dim theDoc As Doc = New Doc()
theDoc.FontSize = 64
Dim theSection As String,theChapter As String,theSubject As String
Dim i, j, k As Integer
For i = 1 To 2
  theDoc.Page = theDoc.AddPage()
  theSection = i.ToString() + " Section"
  theDoc.AddText(theSection)
  theDoc.AddBookmark(theSection, True)
  For j = 1 To 4
    theDoc.Page = theDoc.AddPage()
    theChapter = theSection + "\" + j.ToString() + " Chapter"
    theDoc.AddText(theChapter)
    theDoc.AddBookmark(theChapter, False)
    For k = 1 To 5
      theDoc.Page = theDoc.AddPage()
      theSubject = theChapter + "\" + k.ToString() + " Subject"
      theDoc.AddText(theSubject)
      theDoc.AddBookmark(theSubject, True)
    Next
  Next
Next
theDoc.Save(Server.MapPath("docaddbookmark.pdf"))
theDoc.Clear()


docaddbookmark.pdf