SetNamedDestination(String, PdfExplicitDestination) Method

Definition

Namespace Broadside
Assembly Broadside.dll

Gives destination the name name in the name dictionary's Dests tree.

public PdfNamedDestination SetNamedDestination(string name, PdfExplicitDestination destination)

Parameters

name
String

The name, a text string: an existing key that reads as it is replaced, else it is written in PDFDocEncoding when it can be, else UTF-16BE.

destination
PdfExplicitDestination

An explicit destination of this document.

Returns

PdfNamedDestination
A named destination for name, to give to Destination.

Remarks

ISO 32000-2 §12.3.2.4 (PDF 1.2) and §7.7.4, Table 32. The name dictionary and its Dests tree are created when absent; the key is found as GetNamedDestination(String) finds it (PDFDocEncoding, then UTF-16BE, then every key decoded). A PDF 1.1 entry of the same name in the catalog's Dests dictionary is removed, so both lookups agree. A later save of a document below PDF 1.2 raises it to 1.2. A mutation.