Class
RadFixedDocument

Root fixed document aggregating pages, annotations, form fields, actions, bookmarks, structure tree, and metadata, with merge and clone operations.

Definition

Namespace:Telerik.Windows.Documents.Fixed.Model

Assembly:Telerik.Windows.Documents.Fixed.dll

Syntax:

cs-api-definition
public class RadFixedDocument : FixedDocumentElementBase, IFixedDocument, IDestinationContainer, IFixedDocumentElement

Inheritance: objectFixedDocumentElementBaseRadFixedDocument

Implements: IDestinationContainerIFixedDocumentIFixedDocumentElement

Inherited Members FixedDocumentElementBase.Parent

Constructors

RadFixedDocument(bool)

Create an empty document with initialized collections and optional automatic tagging.

Declaration

cs-api-definition
public RadFixedDocument(bool autoTag = false)

Parameters

autoTag

bool

Properties

AcroForm

Interactive form (AcroForm) container managing form fields and widgets.

Declaration

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

Property Value

AcroForm

Actions

Document-level actions executed on open, close, save, or print events.

Declaration

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

Property Value

DocumentActionCollection

Annotations

Enumerates all annotations across every page (lazy per page load).

Declaration

cs-api-definition
public IEnumerable<Annotation> Annotations { get; }

Property Value

IEnumerable<Annotation>

An enumerable collection of all annotations across all document pages.

AutoTag

Indicates whether new content is auto-tagged for accessibility.

Declaration

cs-api-definition
public bool AutoTag { get; }

Property Value

bool

Bookmarks

Hierarchical outline (bookmarks) tree for structured navigation.

Declaration

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

Property Value

BookmarksCollection

DocumentInfo

Document metadata (info dictionary) including title, author, creation date, etc.

Declaration

cs-api-definition
public RadFixedDocumentInfo DocumentInfo { get; }

Property Value

RadFixedDocumentInfo

The document information object containing metadata properties.

EmbeddedFiles

Embedded file attachments collection.

Declaration

cs-api-definition
public EmbeddedFilesCollection EmbeddedFiles { get; }

Property Value

EmbeddedFilesCollection

The collection of embedded file attachments.

HasLayers

Indicates presence of optional content groups (layers).

Declaration

cs-api-definition
public bool HasLayers { get; }

Property Value

bool

Language

BCP 47 language tag applied to document content.

Declaration

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

Property Value

string

NamedDestinations

Named destination targets enabling internal navigation by name.

Declaration

cs-api-definition
public NamedDestinationsCollection NamedDestinations { get; }

Property Value

NamedDestinationsCollection

The collection of named destinations for document navigation.

PageMode

Initial viewer page display mode (e.g., outline, thumbnails) when opened.

Declaration

cs-api-definition
public PageMode PageMode { get; set; }

Property Value

PageMode

Pages

Ordered page collection forming the document body.

Declaration

cs-api-definition
public PageCollection Pages { get; }

Property Value

PageCollection

The collection containing all pages in the document.

StructureTree

Logical structure tree root describing tagged PDF semantics.

Declaration

cs-api-definition
public StructureTree StructureTree { get; set; }

Property Value

StructureTree

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.

Declaration

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

Property Value

ViewerPreferences

The viewer preferences.

Methods

Clone()

Deep clone the document (pages, form fields, annotations, destinations, files, scripts, bookmarks) into a new instance.

Declaration

cs-api-definition
public RadFixedDocument Clone()

Returns

RadFixedDocument

The cloned RadFixedDocument instance.

Merge(RadFixedDocument)

Merge pages, form fields, destinations, actions, scripts, files, and bookmarks from another document.

Declaration

cs-api-definition
public void Merge(RadFixedDocument source)

Parameters

source

RadFixedDocument

The source document.

ToSimpleTextDocument()

Export a plain text representation of the entire document.

Declaration

cs-api-definition
[Obsolete("This method is obsolete. Please use ToSimpleTextDocument(TimeSpan? timeout) instead.")]
public SimpleTextDocument ToSimpleTextDocument()

Returns

SimpleTextDocument

An instance of SimpleTextDocument representing the plain text version of the document.

ToSimpleTextDocument(TimeSpan?)

Converts the current document to a plain text document.

Declaration

cs-api-definition
public SimpleTextDocument ToSimpleTextDocument(TimeSpan? timeout)

Parameters

timeout

TimeSpan?

The timeout after which the operation will be cancelled.

Returns

SimpleTextDocument

An instance of SimpleTextDocument representing the plain text version of the document.

ToSimpleTextDocument(int, int)

Export a plain text representation limited to the specified page range.

Declaration

cs-api-definition
[Obsolete("This method is obsolete. Please use ToSimpleTextDocument(int startPage, int endPage, TimeSpan? timeout) instead.")]
public SimpleTextDocument ToSimpleTextDocument(int startPage, int endPage)

Parameters

startPage

int

endPage

int

Returns

SimpleTextDocument

An instance of SimpleTextDocument representing the plain text version of the document.

ToSimpleTextDocument(int, int, TimeSpan?)

Converts the current document to a plain text document.

Declaration

cs-api-definition
public SimpleTextDocument ToSimpleTextDocument(int startPage, int endPage, TimeSpan? timeout)

Parameters

startPage

int

The starting page index (inclusive) from which to extract text.

endPage

int

The ending page index (inclusive) up to which to extract text.

timeout

TimeSpan?

The timeout after which the operation will be cancelled.

Returns

SimpleTextDocument

An instance of SimpleTextDocument representing the plain text version of the document.

Events

DocumentUnhandledException

Occurs when an unhandled exception is thrown while loading the document properties, e.g. page content and annotations. This event applies when the document is imported with the PdfFormatProvider class using the ReadingMode.OnDemand import setting.

Declaration

cs-api-definition
public event EventHandler<DocumentUnhandledExceptionEventArgs> DocumentUnhandledException

Event Value

EventHandler<DocumentUnhandledExceptionEventArgs>

MergedEmbeddedFileNameResolving

Raised to resolve duplicate embedded file names during merge.

Declaration

cs-api-definition
public event EventHandler<DuplicatedEmbeddedFileNameResolvingEventArgs> MergedEmbeddedFileNameResolving

Event Value

EventHandler<DuplicatedEmbeddedFileNameResolvingEventArgs>

MergedFieldNameResolving

Raised to resolve duplicate form field names during merge; handler can supply a unique name.

Declaration

cs-api-definition
public event EventHandler<MergedFormFieldNameResolvingEventArgs> MergedFieldNameResolving

Event Value

EventHandler<MergedFormFieldNameResolvingEventArgs>

MergedJavaScriptNameResolving

Raised to resolve duplicate JavaScript action names during merge.

Declaration

cs-api-definition
public event EventHandler<DuplicatedJavaScriptNameResolvingEventArgs> MergedJavaScriptNameResolving

Event Value

EventHandler<DuplicatedJavaScriptNameResolvingEventArgs>