ClassPdfImportSettings
Settings for importing PDF documents, controlling reading mode, stream copying, and event hooks used during the import process.
Definition
Namespace:Telerik.Windows.Documents.Fixed.FormatProviders.Pdf.Import
Assembly:Telerik.Windows.Documents.Fixed.dll
Syntax:
[TypeConverter(typeof(PdfImportSettingsTypeConverter))]
public class PdfImportSettings
Inheritance: objectPdfImportSettings
Constructors
PdfImportSettings()
Creates import settings with ReadingMode set to AllAtOnce and CopyStream set to false.
Declaration
public PdfImportSettings()
Properties
CopyStream
Controls whether the document stream is copied during import. When false and ReadingMode is OnDemand, the original stream must be kept open while the document is in use. When true, the original stream can be disposed after import, regardless of the reading mode.
IgnoreMarkedContent
Instructs the importer to ignore marked content containers (if any) and import only their contained content.
Declaration
public bool IgnoreMarkedContent { get; set; }
Property Value
True if the document should ignore marked content on import; otherwise, false.
ReadAllAtOnce
Default settings for loading all page content on import:
{ ReadingMode = AllAtOnce, CopyStream = false }
Declaration
public static PdfImportSettings ReadAllAtOnce { get; }
Property Value
ReadOnDemand
Default settings for deferred, on-demand page loading:
{ ReadingMode = OnDemand, CopyStream = true }
Declaration
public static PdfImportSettings ReadOnDemand { get; }
Property Value
ReadingMode
Controls how page content is loaded during import. If AllAtOnce applied, the document pages content will be loaded on import. If OnDemand applied, the document pages content will be loaded on demand.
Currently, the OnDemand setting should be applied for use with viewers only.
Declaration
public ReadingMode ReadingMode { get; set; }
Property Value
Events
DocumentUnhandledException
Raised when an unhandled exception occurs during document import; provides error details for logging or recovery.
Declaration
public event EventHandler<DocumentUnhandledExceptionEventArgs> DocumentUnhandledException
Event Value
DuplicatedEmbeddedFileNameResolving
Raised when embedded files share the same name; provides a way to resolve to a unique file name.
Declaration
public event EventHandler<DuplicatedEmbeddedFileNameResolvingEventArgs> DuplicatedEmbeddedFileNameResolving
Event Value
OwnerPasswordNeeded
Raised when an owner password is required to access restricted operations; provides the password to continue import.
Declaration
public event EventHandler<PasswordNeededEventArgs> OwnerPasswordNeeded
Event Value
UserPasswordNeeded
Raised when a user password is required to open the document; provides the password to continue import.
Declaration
public event EventHandler<PasswordNeededEventArgs> UserPasswordNeeded
Event Value