|
def | AssociatedFiles (other) |
| Constructor, with another associated files object. More...
|
|
def | AssociatedFiles (pdf_doc) |
| Constructor, with a PDF document. More...
|
|
def | AssociateFile (pdf_object, file_spec) |
| Associate a file (represented by FileSpec ) with a PDF dictionary object which represents the dictionary of an annotation, a PDF page, or other object in PDF document. More...
|
|
def | GetAssociatedFile (pdf_object, index) |
| Get an associated file (represented by FileSpec ) in a specified PDF dictionary object, by index. More...
|
|
def | GetAssociatedFile (graphics_object, index) |
| Get an associated file a graphics object, by index. More...
|
|
def | GetAssociatedFilesCount (pdf_object) |
| Get the count of associated files in a PDF dictionary object which represents the dictionary of an annotation, a PDF page, or other object in PDF document. More...
|
|
def | GetAssociatedFilesCount (graphics_object) |
| Get the count of associated files in a graphics object. More...
|
|
def | IsEmpty () |
| Check whether current object is empty or not. More...
|
|
def | RemoveAssociatedFile (pdf_object, index) |
| Remove an associated file (represented by FileSpec ) in a specified PDF dictionary object, by index. More...
|
|
def | RemoveAssociatedFile (graphics_object, index) |
| Remove an associated file a graphics object, by index. More...
|
|
|
| e_RelationshipAlternative = _fsdk.AssociatedFiles_e_RelationshipAlternative |
| The relationship is "Alternative" which means the file specification is an alternative representation of content, for example audio.
|
|
| e_RelationshipData = _fsdk.AssociatedFiles_e_RelationshipData |
| The relationship is "Data" which means the file specification represents information used to derive a visual presentation - such as for a table or a graph.
|
|
| e_RelationshipEncryptedPayload = _fsdk.AssociatedFiles_e_RelationshipEncryptedPayload |
| The relationship is "Encrypted payload" which means the file specification is an encrypted payload document that should be displayed to the user if the PDF processor has the cryptographic filter needed to decrypt the document.
|
|
| e_RelationshipFormData = _fsdk.AssociatedFiles_e_RelationshipFormData |
| The relationship is "Form data" which means the file specification is the data associated with the "AcroForm" dictionary in the PDF file.
|
|
| e_RelationshipSchema = _fsdk.AssociatedFiles_e_RelationshipSchema |
| The relationship is "Schema" which means the file specification is a schema definition for the associated object.
|
|
| e_RelationshipSource = _fsdk.AssociatedFiles_e_RelationshipSource |
| The relationship is "Source" which means the file specification is the original source material for the associated content.
|
|
| e_RelationshipSupplement = _fsdk.AssociatedFiles_e_RelationshipSupplement |
| The relationship is "Supplement" which means the file specification represents a supplemental representation of the original source or data that may be more easily consumable.
|
|
| e_RelationshipUnspecified = _fsdk.AssociatedFiles_e_RelationshipUnspecified |
| The relationship is not known or cannot be described by other values.
|
|
In PDF 2.0, a new concept named "Associated files" is defined. Associated files provide a means to associate content in other formats with objects of a PDF file and identify the relationship between the content and the objects. Such associated files are designated using file specification dictionaries (known as file specification). Associated files could be linked to the PDF document's catalog, a page dictionary, graphics objects, structure elements, XObject, DParts, an annotation dictionary and so on. Specially, associated files with graphics objects means to be associated with the marked content item.
Class AssociatedFiles is the class for managing associate files. It offers the functions to count/get associate files in PDF dictionary or graphics object, to associate files (represented by FileSpec ) with catalog, PDF pages, graphics objects, form XObject objects, annotation objects and so on.
Specially, when construct an associated files object with a PDF document, the file version of the related PDF document will be set to 2.0.
def FoxitPDFSDKPython3.AssociatedFiles.AssociateFile |
( |
|
pdf_object, |
|
|
|
file_spec |
|
) |
| |
Associate a file (represented by FileSpec ) with a PDF dictionary object which represents the dictionary of an annotation, a PDF page, or other object in PDF document.
Associate a file (represented by FileSpec ) with a PDF annotation.
Associate a file (represented by FileSpec ) with a form XObject graphics object.
Associate a file (represented by FileSpec ) with an image graphics object.
Associate a file (represented by FileSpec ) with a PDF page.
Associate a file (represented by FileSpec ) with a marked content item of a specified graphics object.
- Parameters
-
[in] | pdf_object | A valid PDF object. It should be either a PDF dictionary object or a PDF reference object that refers to a PDF dictionary object. |
[in] | file_spec | A file specification object to be associated with specified PDF dictionary. It should not be an empty string. |
- Returns
- None.
- Parameters
-
[in] | graphics_object | A valid graphics object. |
[in] | mark_content_item_index | The index of marked content item in input graphic object to which the specified file specification object is to associated with. Valid range: from 0 to (count-1). count is returned by function FoxitPDFSDKPython3.MarkedContent.GetItemCount of the marked content related to input graphics object. |
[in] | current_resource | A resource dictionary of a PDF page to which input graphics object is related. This can also be a PDF reference object that refers to such a PDF dictionary. |
[in] | property_name | A property name used in "Properties" dictionary of input resource dictionary. It should not be an empty string. |
[in] | file_spec | A file specification object to be associated with specified marked content item of a specified graphics object. It should not be an empty string. |
- Returns
- None.
- Note
- When this function succeeds, function FoxitPDFSDKPython3.GraphicsObjects.GenerateContent should be called. Please refer to function FoxitPDFSDKPython3.GraphicsObjects.GenerateContent for more details.
In fact, this function is equals to associate a file with a PDF page dictionary.
- Parameters
-
[in] | page | A valid PDF page. |
[in] | file_spec | A file specification object to be associated with specified PDF page. It should not be an empty string. |
- Returns
- None.
In fact, this function is equals to associate a file with a PDF dictionary of an image graphics object.
- Parameters
-
[in] | image | An image graphics object. It should not be null. |
[in] | file_spec | A file specification object to be associated with specified image graphics object. It should not be an empty string. |
- Returns
- None.
In fact, this function is equals to associate a file with a PDF dictionary of a form XObject graphics object.
- Parameters
-
[in] | form_xobject | A form XObject graphics object. It should not be null. |
[in] | file_spec | A file specification object to be associated with specified form XObject graphics object. It should not be an empty string. |
- Returns
- None.
In fact, this function is equals to associate a file with a PDF dictionary of a PDF annotation.
- Parameters
-
[in] | annot | A valid PDF annotation. |
[in] | file_spec | A file specification object to be associated with specified PDF annotation object. It should not be an empty string. |
- Returns
- None.