Class
BookmarkItem

Bookmark node in the PDF outline that triggers a destination or action and structures hierarchical navigation.

Definition

Namespace:Telerik.Windows.Documents.Fixed.Model.Navigation

Assembly:Telerik.Windows.Documents.Fixed.dll

Syntax:

cs-api-definition
public class BookmarkItem : FixedDocumentElementBase, IFixedDocumentElement

Inheritance: objectFixedDocumentElementBaseBookmarkItem

Implements: IFixedDocumentElement

Inherited Members FixedDocumentElementBase.Parent

Constructors

BookmarkItem(string, Action)

Create a new BookmarkItem that executes the provided action (and subsequent actions in the collection) when activated.

Declaration

cs-api-definition
public BookmarkItem(string title, Action action)

Parameters

title

string

The text to be displayed for this bookmark item.

action

Action

The action first action in a collection of actions to be performed when this bookmark item is activated.

Exceptions

ArgumentNullException

Thrown when the title or action is null.

BookmarkItem(string, Destination)

Create a new BookmarkItem that navigates to the specified destination when activated.

Declaration

cs-api-definition
public BookmarkItem(string title, Destination destination)

Parameters

title

string

The text to be displayed for this bookmark item.

destination

Destination

The destination to be displayed when this bookmark item is activated.

Exceptions

ArgumentNullException

Thrown when the title or destination is null.

BookmarkItem(string, NamedDestination)

Create a new BookmarkItem that targets the specified named destination for indirect navigation.

Declaration

cs-api-definition
public BookmarkItem(string title, NamedDestination namedDestination)

Parameters

title

string

The text to be displayed for this bookmark item.

namedDestination

NamedDestination

The named destination to be displayed when this bookmark item is activated.

Exceptions

ArgumentNullException

Thrown when the title or namedDestination is null.

Properties

Actions

Gets the ordered collection of actions executed when the bookmark is activated.

Declaration

cs-api-definition
public ActionCollection Actions { get; }

Property Value

ActionCollection

The actions.

Children

Gets the collection of direct child bookmarks forming this node's subtree.

Declaration

cs-api-definition
public BookmarksCollection Children { get; }

Property Value

BookmarksCollection

Destination

Gets the destination shown in the viewer when the bookmark is activated.

Declaration

cs-api-definition
public Destination Destination { get; }

Property Value

Destination

IsExpanded

Gets or sets whether this bookmark's child items are initially expanded when the document loads, controlling outline visibility.

Declaration

cs-api-definition
public bool IsExpanded { get; set; }

Property Value

bool

NamedDestination

Gets the named destination this bookmark resolves to for indirection across the document.

Declaration

cs-api-definition
public NamedDestination NamedDestination { get; }

Property Value

NamedDestination

TextColor

Gets or sets the bookmark text color (RGB), influencing outline appearance.

Declaration

cs-api-definition
public RgbColor TextColor { get; set; }

Property Value

RgbColor

Exceptions

ArgumentNullException

Thrown when the value is null.

TextStyle

Gets or sets the visual style flags (bold / italic) applied to the bookmark text.

Declaration

cs-api-definition
public BookmarkItemStyles TextStyle { get; set; }

Property Value

BookmarkItemStyles

Title

Gets or sets the display text shown for the bookmark in the outline panel.

Declaration

cs-api-definition
public string Title { get; set; }

Property Value

string

Exceptions

ArgumentNullException

Thrown when the value is null.