pdftools_sdk.document_assembly.page_copy_options

Classes

PageCopyOptions()

This class determines whether and how different PDF elements are copied.

class pdftools_sdk.document_assembly.page_copy_options.PageCopyOptions[source]

Bases: _NativeObject

This class determines whether and how different PDF elements are copied.

__init__()[source]

property links: CopyStrategy

Copy strategy for links.

Specifies how links (document internal and external links) are treated when copying a page.

Default value: pdftools_sdk.document_assembly.copy_strategy.CopyStrategy.COPY

Returns:: pdftools_sdk.document_assembly.copy_strategy.CopyStrategy

property form_fields: CopyStrategy

Copy strategy for form fields.

Specifies how form fields are treated when copying a page.

Default value: pdftools_sdk.document_assembly.copy_strategy.CopyStrategy.COPY

Returns:: pdftools_sdk.document_assembly.copy_strategy.CopyStrategy

property signed_signatures: RemovalStrategy

Removal strategy for signed signature fields.

Signed digital signatures are always invalidated when copying a page and therefore have to be removed. This property specifies, whether the visual representation of the signature is preserved.

Default value: pdftools_sdk.document_assembly.removal_strategy.RemovalStrategy.REMOVE

Returns:: pdftools_sdk.document_assembly.removal_strategy.RemovalStrategy

property unsigned_signatures: CopyStrategy

Copy strategy for unsigned signature fields.

Specifies how signature fields are treated, that are not yet signed.

Default value: pdftools_sdk.document_assembly.copy_strategy.CopyStrategy.COPY

Returns:: pdftools_sdk.document_assembly.copy_strategy.CopyStrategy

property annotations: CopyStrategy

Copy strategy for annotations.

Specifies how interactive annotations (like sticky notes or text highlights) are treated when copying a page. This does not include links, form fields and signature fields which are not considered annotations in this product.

Default value: pdftools_sdk.document_assembly.copy_strategy.CopyStrategy.COPY

Returns:: pdftools_sdk.document_assembly.copy_strategy.CopyStrategy

property copy_outline_items: bool

Copy outline items (bookmarks).

Specifies whether outline items (also known as bookmarks) pointing to the copied page should be copied to the target document automatically.

Default value: True

Returns:: bool

property copy_associated_files: bool

Copy associated files.

Specifies whether embedded files associated with a page or any of its subobjects are also copied when copying the page.

Default value: True

Returns:: bool

property copy_logical_structure: bool

Copy the logical structure and tagging information.

Specifies whether the logical structure and tagging information associated with a page or its content is also copied when copying the page.

This is required if the target document conformance is PDF/A Level a.

Default value: True

Returns:: bool

property form_field_conflict_resolution: NameConflictResolution

Resolution of conflicting form field names.

Form field of different files can have the same name (identifier). This property specifies how name conflicts are resolved, when copying pages from multiple source files.

Default value: pdftools_sdk.document_assembly.name_conflict_resolution.NameConflictResolution.MERGE

Returns:: pdftools_sdk.document_assembly.name_conflict_resolution.NameConflictResolution

property named_destinations: NamedDestinationCopyStrategy

Copy strategy for named destinations

Specify whether named destinations are resolved when copying a page.

Default value: pdftools_sdk.document_assembly.named_destination_copy_strategy.NamedDestinationCopyStrategy.COPY

Returns:: pdftools_sdk.document_assembly.named_destination_copy_strategy.NamedDestinationCopyStrategy

property optimize_resources: bool

Find and merge redundant resources.

Find and merge redundant resources such as fonts and images. This can lead to much smaller files, especially when copying pages from multiple similar source files. However, it also results in longer processing time.

Default value: True

Returns:: bool

property page_rotation: PageRotation

Specify how page(s) should be rotated.

Default is pdftools_sdk.document_assembly.page_rotation.PageRotation.NOROTATION

Returns:: pdftools_sdk.document_assembly.page_rotation.PageRotation