RadFixedDocument
RadFixedDocument is a core class in the Telerik Document Processing libraries, specifically within the PdfProcessing model.
This article will get you familiar with the basics of RadFixedDocument. It contains the following sections:
What Is RadFixedDocument
RadFixedDocument is the main document unit of the PdfProcessing model. It represents the root element of a fixed-layout PDF document and serves as the container for all other document elements. RadFixedDocument holds a collection of RadFixedPage elements. It exposes the following public API:
| Property Name | Description |
|---|---|
| Pages | The pages collection that contains all RadFixedPages in the document. |
| Annotations | A read-only collection that contains all Annotations in the document. |
| Destinations | A collection that contains all Destinations in the document. |
| DocumentInfo | Contains additional meta information about the document like author, title, etc. |
| Actions | Gets the document actions collection. (introduced in Q4 2024) |
| NamedDestinations | Gets the collection of named destinations that provide bookmark-like navigation points within the document. |
| EmbeddedFiles | Gets the collection of files embedded within this document as attachments. |
| AcroForm | Gets the interactive form (AcroForm) that manages form fields elements within the document. |
| Bookmarks | Gets the hierarchical collection of bookmarks (outline items) that provide structured navigation through the document. |
| PageMode | Gets or sets the page display mode that determines how the document appears when first opened in a PDF viewer. |
| HasLayers | Gets whether the document has layers. (introduced in Q4 2024) |
| Language | Gets or sets the language of the document. (introduced in Q3 2025) |
| StructureTree | Gets or sets the structure tree of the document. (introduced in Q3 2025) |
| AutoTag | Gets a value indicating whether the document is set to automatically tag elements. If true, the document will automatically tag elements with structure tags when they are added. (introduced in Q3 2025) |
| ViewerPreferences | Gets the viewer preferences controlling the way the document is to be presented on the screen or in print. If no such dictionary is specified, viewing and printing applications should behave in accordance with their own current user preference settings. (introduced in Q3 2025) |
| Method | Description |
|---|---|
| Merge | Merges this document with the specified source document. |
| Clone | Clones the document content. |
| ToSimpleTextDocument | Converts the current document to a plain text document. |
| Event | Description |
|---|---|
| MergedFieldNameResolving | Occurs when trying to resolve conflicts between the fields names while merging RadFixedDocument instances. |
| MergedEmbeddedFileNameResolving | Occurs when trying to resolve conflicts between the embedded file names while merging RadFixedDocument instances. |
| MergedJavaScriptNameResolving | Occurs when trying to resolve conflicts between the JavaScript names while merging RadFixedDocument instances. |
RadFixedDocument is typically used when:
- Creating a PDF document from scratch programmatically: a complete example is available in the PdfProcessing Basic Usage demo.
- Extracting or manipulating content from existing PDF documents: first import any existing PDF documents with the help of the PdfFormatProvider.
- Generating structured, fixed-layout documents with precise control over layout and formatting: FixedContentEditor and RadFixedDocumentEditor allow you to create a RadFixedDocument either with managing the position or in a flow-like manner and insert all desired elements one after another.
A complete SDK example how to generate a document is available here.
Example 1 shows how you can create a new RadFixedDocument instance.
Example 1: Create RadFixedDocument
RadFixedDocument document = new RadFixedDocument();Operating with RadFixedDocument
There are different actions, which you can execute with the help of RadFixedDocument. For example, you can add a RadFixedPage to an existing document.
Example 2 adds a page to the document created in Example 1.
Example 2: Add page to RadFixedDocument
RadFixedPage page = document.Pages.AddPage();Alternatively, you can create new RadFixedPage and add it to the Pages collection of a document.
Example 3 creates a page and adds it to the document created in Example 1.
Example 3: Create and add a page to RadFixedDocument
RadFixedPage newPage = new RadFixedPage();
document.Pages.Add(newPage);Example 4 shows you how you could obtain a copy of a RadFixedDocument.
Example 4: Clone a document
RadFixedDocument clonedDocument = document.Clone();You can merge PDF documents out-of-the-box with the Merge() method of RadFixedDocument. This method clones the source document and appends it to the current instance of RadFixedDocument.
Example 5: Merge documents
document.Merge(clonedDocument);The code from Example 5 merges the document created in Example 1 with another RadFixedDocument.
Document Information
RadFixedDocument exposes a DocumentInfo property of type RadFixedDocumentInfo, intended to hold additional information about the document.