PDF Toolbox
Loading...
Searching...
No Matches
Macros | Functions
PdfTools_Toolbox_PtxPdf.h File Reference
#include "PdfTools_Toolbox_Types.h"
#include "PdfTools_Toolbox_PtxSys.h"

Go to the source code of this file.

Macros

#define PDFTOOLS_TOOLBOX_CALL
 
#define PtxPdf_Encryption_New   PtxPdf_Encryption_NewA
 
#define PtxPdf_Encryption_GetUserPassword   PtxPdf_Encryption_GetUserPasswordA
 
#define PtxPdf_Encryption_SetUserPassword   PtxPdf_Encryption_SetUserPasswordA
 
#define PtxPdf_Encryption_GetOwnerPassword   PtxPdf_Encryption_GetOwnerPasswordA
 
#define PtxPdf_Encryption_SetOwnerPassword   PtxPdf_Encryption_SetOwnerPasswordA
 
#define PtxPdf_OptionalContentGroup_GetName   PtxPdf_OptionalContentGroup_GetNameA
 
#define PtxPdf_Document_Open   PtxPdf_Document_OpenA
 
#define PtxPdf_Document_OpenWithFdf   PtxPdf_Document_OpenWithFdfA
 
#define PtxPdf_Document_GetLanguage   PtxPdf_Document_GetLanguageA
 
#define PtxPdf_Document_SetLanguage   PtxPdf_Document_SetLanguageA
 
#define PtxPdf_Page_GetPageLabel   PtxPdf_Page_GetPageLabelA
 
#define PtxPdf_Metadata_GetTitle   PtxPdf_Metadata_GetTitleA
 
#define PtxPdf_Metadata_SetTitle   PtxPdf_Metadata_SetTitleA
 
#define PtxPdf_Metadata_GetAuthor   PtxPdf_Metadata_GetAuthorA
 
#define PtxPdf_Metadata_SetAuthor   PtxPdf_Metadata_SetAuthorA
 
#define PtxPdf_Metadata_GetSubject   PtxPdf_Metadata_GetSubjectA
 
#define PtxPdf_Metadata_SetSubject   PtxPdf_Metadata_SetSubjectA
 
#define PtxPdf_Metadata_GetKeywords   PtxPdf_Metadata_GetKeywordsA
 
#define PtxPdf_Metadata_SetKeywords   PtxPdf_Metadata_SetKeywordsA
 
#define PtxPdf_Metadata_GetCreator   PtxPdf_Metadata_GetCreatorA
 
#define PtxPdf_Metadata_SetCreator   PtxPdf_Metadata_SetCreatorA
 
#define PtxPdf_Metadata_GetProducer   PtxPdf_Metadata_GetProducerA
 
#define PtxPdf_FileReference_Create   PtxPdf_FileReference_CreateA
 
#define PtxPdf_FileReference_GetAssociationRelationship   PtxPdf_FileReference_GetAssociationRelationshipA
 
#define PtxPdf_FileReference_SetAssociationRelationship   PtxPdf_FileReference_SetAssociationRelationshipA
 
#define PtxPdf_FileReference_GetDescription   PtxPdf_FileReference_GetDescriptionA
 
#define PtxPdf_FileReference_GetMediaType   PtxPdf_FileReference_GetMediaTypeA
 
#define PtxPdf_FileReference_GetName   PtxPdf_FileReference_GetNameA
 

Functions

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_PageCopyOptions *PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_New (void)
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_CopyStrategy PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetLinks (TPtxPdf_PageCopyOptions *pPageCopyOptions)
 Copy strategy for links.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetLinks (TPtxPdf_PageCopyOptions *pPageCopyOptions, TPtxPdf_CopyStrategy iLinks)
 Copy strategy for links.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdfForms_FormFieldCopyStrategy PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetFormFields (TPtxPdf_PageCopyOptions *pPageCopyOptions)
 Copy strategy for form fields and widgets.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetFormFields (TPtxPdf_PageCopyOptions *pPageCopyOptions, TPtxPdfForms_FormFieldCopyStrategy iFormFields)
 Copy strategy for form fields and widgets.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_RemovalStrategy PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetSignedSignatures (TPtxPdf_PageCopyOptions *pPageCopyOptions)
 Removal strategy for signed signature fields.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetSignedSignatures (TPtxPdf_PageCopyOptions *pPageCopyOptions, TPtxPdf_RemovalStrategy iSignedSignatures)
 Removal strategy for signed signature fields.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_CopyStrategy PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetUnsignedSignatures (TPtxPdf_PageCopyOptions *pPageCopyOptions)
 Copy strategy for unsigned signature fields.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetUnsignedSignatures (TPtxPdf_PageCopyOptions *pPageCopyOptions, TPtxPdf_CopyStrategy iUnsignedSignatures)
 Copy strategy for unsigned signature fields.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_CopyStrategy PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetAnnotations (TPtxPdf_PageCopyOptions *pPageCopyOptions)
 Copy strategy for annotations.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetAnnotations (TPtxPdf_PageCopyOptions *pPageCopyOptions, TPtxPdf_CopyStrategy iAnnotations)
 Copy strategy for annotations.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetCopyOutlineItems (TPtxPdf_PageCopyOptions *pPageCopyOptions)
 Copy outline items (bookmarks).
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetCopyOutlineItems (TPtxPdf_PageCopyOptions *pPageCopyOptions, BOOL bCopyOutlineItems)
 Copy outline items (bookmarks).
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetCopyAssociatedFiles (TPtxPdf_PageCopyOptions *pPageCopyOptions)
 Copy associated files.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetCopyAssociatedFiles (TPtxPdf_PageCopyOptions *pPageCopyOptions, BOOL bCopyAssociatedFiles)
 Copy associated files.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetCopyLogicalStructure (TPtxPdf_PageCopyOptions *pPageCopyOptions)
 Copy the logical structure and tagging information.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetCopyLogicalStructure (TPtxPdf_PageCopyOptions *pPageCopyOptions, BOOL bCopyLogicalStructure)
 Copy the logical structure and tagging information.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_NameConflictResolution PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetFormFieldConflictResolution (TPtxPdf_PageCopyOptions *pPageCopyOptions)
 Resolution of conflicting form field names.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetFormFieldConflictResolution (TPtxPdf_PageCopyOptions *pPageCopyOptions, TPtxPdf_NameConflictResolution iFormFieldConflictResolution)
 Resolution of conflicting form field names.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_NameConflictResolution PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetOcgConflictResolution (TPtxPdf_PageCopyOptions *pPageCopyOptions)
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetOcgConflictResolution (TPtxPdf_PageCopyOptions *pPageCopyOptions, TPtxPdf_NameConflictResolution iOcgConflictResolution)
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdfNav_NamedDestinationCopyStrategy PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetNamedDestinations (TPtxPdf_PageCopyOptions *pPageCopyOptions)
 Copy strategy for named destinations.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetNamedDestinations (TPtxPdf_PageCopyOptions *pPageCopyOptions, TPtxPdfNav_NamedDestinationCopyStrategy iNamedDestinations)
 Copy strategy for named destinations.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetOptimizeResources (TPtxPdf_PageCopyOptions *pPageCopyOptions)
 Find and merge redundant resources.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetOptimizeResources (TPtxPdf_PageCopyOptions *pPageCopyOptions, BOOL bOptimizeResources)
 Find and merge redundant resources.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Encryption *PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_NewA (const char *szUserPassword, const char *szOwnerPassword, TPtxPdf_Permission iPermissions)
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Encryption *PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_NewW (const WCHAR *szUserPassword, const WCHAR *szOwnerPassword, TPtxPdf_Permission iPermissions)
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_GetUserPasswordA (TPtxPdf_Encryption *pEncryption, char *pBuffer, size_t nBufferSize)
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_GetUserPasswordW (TPtxPdf_Encryption *pEncryption, WCHAR *pBuffer, size_t nBufferSize)
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_SetUserPasswordA (TPtxPdf_Encryption *pEncryption, const char *szUserPassword)
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_SetUserPasswordW (TPtxPdf_Encryption *pEncryption, const WCHAR *szUserPassword)
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_GetOwnerPasswordA (TPtxPdf_Encryption *pEncryption, char *pBuffer, size_t nBufferSize)
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_GetOwnerPasswordW (TPtxPdf_Encryption *pEncryption, WCHAR *pBuffer, size_t nBufferSize)
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_SetOwnerPasswordA (TPtxPdf_Encryption *pEncryption, const char *szOwnerPassword)
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_SetOwnerPasswordW (TPtxPdf_Encryption *pEncryption, const WCHAR *szOwnerPassword)
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Permission PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_GetPermissions (TPtxPdf_Encryption *pEncryption)
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_SetPermissions (TPtxPdf_Encryption *pEncryption, TPtxPdf_Permission iPermissions)
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_PageList *PDFTOOLS_TOOLBOX_CALL PtxPdf_PageList_Copy (TPtxPdf_Document *pTargetDocument, TPtxPdf_PageList *pPageList, TPtxPdf_PageCopyOptions *pOptions)
 Copy a page list Copy pages from an input document to the given pTargetDocument. The returned list is associated with the given target document but not yet part of it. It can be appended to the document's page list.
 
PDFTOOLS_TOOLBOX_EXPORT int PDFTOOLS_TOOLBOX_CALL PtxPdf_PageList_GetCount (TPtxPdf_PageList *pPageList)
 Get the number of elements in the list.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Page *PDFTOOLS_TOOLBOX_CALL PtxPdf_PageList_Get (TPtxPdf_PageList *pPageList, int iIndex)
 Returns the element at the specified position in the given list.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_PageList *PDFTOOLS_TOOLBOX_CALL PtxPdf_PageList_GetRange (TPtxPdf_PageList *pPageList, int iIndex, int iCount)
 Get range of elements.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageList_Add (TPtxPdf_PageList *pPageList, TPtxPdf_Page *pPage)
 Add an element to the end of the list.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageList_AddRange (TPtxPdf_PageList *pPageList, TPtxPdf_PageList *pInput)
 Add range of elements to th end of the list.
 
PDFTOOLS_TOOLBOX_EXPORT int PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReferenceList_GetCount (TPtxPdf_FileReferenceList *pFileReferenceList)
 Get the number of elements in the list.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_FileReference *PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReferenceList_Get (TPtxPdf_FileReferenceList *pFileReferenceList, int iIndex)
 Returns the element at the specified position in the given list.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReferenceList_Add (TPtxPdf_FileReferenceList *pFileReferenceList, TPtxPdf_FileReference *pFileReference)
 Add an element to the end of the list.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_OptionalContentGroup_GetNameA (TPtxPdf_OptionalContentGroup *pOptionalContentGroup, char *pBuffer, size_t nBufferSize)
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_OptionalContentGroup_GetNameW (TPtxPdf_OptionalContentGroup *pOptionalContentGroup, WCHAR *pBuffer, size_t nBufferSize)
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_OcgState PDFTOOLS_TOOLBOX_CALL PtxPdf_OptionalContentGroup_GetState (TPtxPdf_OptionalContentGroup *pOptionalContentGroup)
 
PDFTOOLS_TOOLBOX_EXPORT int PDFTOOLS_TOOLBOX_CALL PtxPdf_OptionalContentGroupList_GetCount (TPtxPdf_OptionalContentGroupList *pOptionalContentGroupList)
 Get the number of elements in the list.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_OptionalContentGroup *PDFTOOLS_TOOLBOX_CALL PtxPdf_OptionalContentGroupList_Get (TPtxPdf_OptionalContentGroupList *pOptionalContentGroupList, int iIndex)
 Returns the element at the specified position in the given list.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Document *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_OpenA (const TPtxSys_StreamDescriptor *pStreamDesc, const char *szPassword)
 Open a PDF document. Documents opened with this method are read-only and cannot be modified.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Document *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_OpenW (const TPtxSys_StreamDescriptor *pStreamDesc, const WCHAR *szPassword)
 Open a PDF document. Documents opened with this method are read-only and cannot be modified.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Document *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_OpenWithFdfA (const TPtxSys_StreamDescriptor *pPdfStreamDesc, const TPtxSys_StreamDescriptor *pFdfStreamDesc, const char *szPassword)
 Open a PDF document together with an FDF file. Documents opened with this method are read-only and cannot be modified.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Document *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_OpenWithFdfW (const TPtxSys_StreamDescriptor *pPdfStreamDesc, const TPtxSys_StreamDescriptor *pFdfStreamDesc, const WCHAR *szPassword)
 Open a PDF document together with an FDF file. Documents opened with this method are read-only and cannot be modified.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Document *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_Create (const TPtxSys_StreamDescriptor *pStreamDesc, const TPtxPdf_Conformance *pConformance, TPtxPdf_Encryption *pEncryption)
 Create a new PDF document. Documents with created with this method are writable and can be modified.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Document *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_CreateWithFdf (const TPtxSys_StreamDescriptor *pPdfStreamDesc, const TPtxSys_StreamDescriptor *pFdfStreamDesc, const TPtxPdf_Conformance *pConformance, TPtxPdf_Encryption *pEncryption)
 Create a new PDF document and an associated FDF. Documents with created with this method are writable and can be modified. When creating a document with this method, all TPtxPdfAnnots_MarkupAnnotations - created or copied - are stored as an FDF file to the pFdfStreamDesc. In the output PDF (pPdfStreamDesc), only annotations that are not TPtxPdfAnnots_MarkupAnnotations are stored.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetLanguageA (TPtxPdf_Document *pDocument, char *pBuffer, size_t nBufferSize)
 the default language for the document. A language identifier specifying the natural language for all text in the document except where overridden by language specifications for structure elements or marked content. If this entry is absent, the language is considered unknown.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetLanguageW (TPtxPdf_Document *pDocument, WCHAR *pBuffer, size_t nBufferSize)
 the default language for the document. A language identifier specifying the natural language for all text in the document except where overridden by language specifications for structure elements or marked content. If this entry is absent, the language is considered unknown.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_SetLanguageA (TPtxPdf_Document *pDocument, const char *szLanguage)
 the default language for the document. A language identifier specifying the natural language for all text in the document except where overridden by language specifications for structure elements or marked content. If this entry is absent, the language is considered unknown.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_SetLanguageW (TPtxPdf_Document *pDocument, const WCHAR *szLanguage)
 the default language for the document. A language identifier specifying the natural language for all text in the document except where overridden by language specifications for structure elements or marked content. If this entry is absent, the language is considered unknown.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_OptionalContentGroupList *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetOptionalContentGroups (TPtxPdf_Document *pDocument)
 The optional content groups (layers) of the document.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Conformance PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetConformance (TPtxPdf_Document *pDocument)
 the claimed conformance of the document. This method only returns the claimed conformance level, the document is not validated.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Metadata *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetMetadata (TPtxPdf_Document *pDocument)
 the metadata of the document. If the document is writable, the metadata object will be writable too and all changes to the metadata object are reflected in the document.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_SetMetadata (TPtxPdf_Document *pDocument, TPtxPdf_Metadata *pMetadata)
 the metadata of the document. If the document is writable, the metadata object will be writable too and all changes to the metadata object are reflected in the document.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_PageList *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetPages (TPtxPdf_Document *pDocument)
 the pages of the document. If the document is writable, it is possible to append new pages to the end of the list.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdfContent_IccBasedColorSpace *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetOutputIntent (TPtxPdf_Document *pDocument)
 the output intent of the document. The output intent specifies a color profile that characterizes the intended output device. It is used to render device colors on devices other than the intended output device.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_SetOutputIntent (TPtxPdf_Document *pDocument, TPtxPdfContent_IccBasedColorSpace *pOutputIntent)
 the output intent of the document. The output intent specifies a color profile that characterizes the intended output device. It is used to render device colors on devices other than the intended output device.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdfForms_FieldNodeMap *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetFormFields (TPtxPdf_Document *pDocument)
 The form fields of the document This list contains all AcroForm form fields that belong to this document. Adding to this list results in an error:
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdfForms_SignatureFieldList *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetSignatureFields (TPtxPdf_Document *pDocument)
 The signature fields of the document Signature fields are a special kind of form fields, that can contain digital signatures.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_FileReferenceList *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetPlainEmbeddedFiles (TPtxPdf_Document *pDocument)
 plain embedded files
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_FileReferenceList *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetAssociatedFiles (TPtxPdf_Document *pDocument)
 document-associated files
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_FileReferenceList *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetAllEmbeddedFiles (TPtxPdf_Document *pDocument)
 plain embedded, associated, and attached files
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdfNav_OutlineItemList *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetOutline (TPtxPdf_Document *pDocument)
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdfNav_Destination *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetOpenDestination (TPtxPdf_Document *pDocument)
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_SetOpenDestination (TPtxPdf_Document *pDocument, TPtxPdfNav_Destination *pOpenDestination)
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetPermissions (TPtxPdf_Document *pDocument, TPtxPdf_Permission *pPermissions)
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdfNav_ViewerSettings *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetViewerSettings (TPtxPdf_Document *pDocument)
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_SetViewerSettings (TPtxPdf_Document *pDocument, TPtxPdfNav_ViewerSettings *pViewerSettings)
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_IsLinearized (TPtxPdf_Document *pDocument)
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_Close (TPtxPdf_Document *pObject)
 Close object.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Page *PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_Create (TPtxPdf_Document *pTargetDocument, const TPtxGeomReal_Size *pSize)
 Create an empty page The page is associated with the given target document but not yet part of it. It can be appended to the document's PtxPdf_Document_GetPages.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Page *PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_Copy (TPtxPdf_Document *pTargetDocument, TPtxPdf_Page *pPage, TPtxPdf_PageCopyOptions *pOptions)
 Copy a page Copy a page object from an input document to the given pTargetDocument. The returned object is associated with the given target document but not yet part of it. It can be appended to the document's PtxPdf_Document_GetPages.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_UpdateSize (TPtxPdf_Page *pPage, const TPtxGeomReal_Rectangle *pRectangle)
 Update the page size to a specified rectangle. Note that all page-related coordinates are normalized to the crop box of the page. Updating the page size thus changes the coordinate system, rendering all previously extracted coordinates invalid.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_Rotate (TPtxPdf_Page *pPage, TPtxGeom_Rotation iRotate)
 Rotate the page by a multiple of 90 degrees.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxGeom_Rotation PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_GetRotation (TPtxPdf_Page *pPage)
 The current page rotation.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_GetSize (TPtxPdf_Page *pPage, TPtxGeomReal_Size *pSize)
 The visible size of the page (crop box).
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_GetMediaBox (TPtxPdf_Page *pPage, TPtxGeomReal_Rectangle *pMediaBox)
 The media box of the page.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_GetBleedBox (TPtxPdf_Page *pPage, TPtxGeomReal_Rectangle *pBleedBox)
 The bleed box of the page.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_GetTrimBox (TPtxPdf_Page *pPage, TPtxGeomReal_Rectangle *pTrimBox)
 The trim box of the page.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_GetArtBox (TPtxPdf_Page *pPage, TPtxGeomReal_Rectangle *pArtBox)
 The art box of the page.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdfContent_Content *PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_GetContent (TPtxPdf_Page *pPage)
 the page content. If the page is writable, the content object can be used to apply new content on the page, for example overlays or underlays.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdfAnnots_AnnotationList *PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_GetAnnotations (TPtxPdf_Page *pPage)
 the list of this page's annotations. Adding to this list results in an error:
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdfNav_LinkList *PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_GetLinks (TPtxPdf_Page *pPage)
 the list of this page's links. Adding to this list results in an error:
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdfForms_WidgetList *PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_GetWidgets (TPtxPdf_Page *pPage)
 the list of this page's form field widgets. Adding to this list results in an error:
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Metadata *PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_GetMetadata (TPtxPdf_Page *pPage)
 the metadata of the page.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_SetMetadata (TPtxPdf_Page *pPage, TPtxPdf_Metadata *pMetadata)
 the metadata of the page.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_GetPageLabelA (TPtxPdf_Page *pPage, char *pBuffer, size_t nBufferSize)
 Page label.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_GetPageLabelW (TPtxPdf_Page *pPage, WCHAR *pBuffer, size_t nBufferSize)
 Page label.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Metadata *PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_Create (TPtxPdf_Document *pTargetDocument, const TPtxSys_StreamDescriptor *pXmp)
 Create a new metadata object The newly created metadata object is associated with the target document but not (yet) used as the document metadata. The object can be used either as document metadata using PtxPdf_Document_SetMetadata or as page metadata using PtxPdf_Page_SetMetadata.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Metadata *PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_Copy (TPtxPdf_Document *pTargetDocument, TPtxPdf_Metadata *pMetadata)
 Copy a metadata object Copy a metadata object from an input document to the given pTargetDocument. The returned object is associated with the target document but not (yet) used as the document metadata. The object can be used either as document metadata using PtxPdf_Document_SetMetadata or as page metadata using PtxPdf_Page_SetMetadata.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetTitleA (TPtxPdf_Metadata *pMetadata, char *pBuffer, size_t nBufferSize)
 The title of the document or resource. This property corresponds to the "dc:title" entry in the XMP metadata and to the "Title" entry in the document information dictionary.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetTitleW (TPtxPdf_Metadata *pMetadata, WCHAR *pBuffer, size_t nBufferSize)
 The title of the document or resource. This property corresponds to the "dc:title" entry in the XMP metadata and to the "Title" entry in the document information dictionary.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_SetTitleA (TPtxPdf_Metadata *pMetadata, const char *szTitle)
 The title of the document or resource. This property corresponds to the "dc:title" entry in the XMP metadata and to the "Title" entry in the document information dictionary.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_SetTitleW (TPtxPdf_Metadata *pMetadata, const WCHAR *szTitle)
 The title of the document or resource. This property corresponds to the "dc:title" entry in the XMP metadata and to the "Title" entry in the document information dictionary.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetAuthorA (TPtxPdf_Metadata *pMetadata, char *pBuffer, size_t nBufferSize)
 The name of the person who created the document or resource. This property corresponds to the "dc:creator" entry in the XMP metadata and to the "Author" entry in the document information dictionary.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetAuthorW (TPtxPdf_Metadata *pMetadata, WCHAR *pBuffer, size_t nBufferSize)
 The name of the person who created the document or resource. This property corresponds to the "dc:creator" entry in the XMP metadata and to the "Author" entry in the document information dictionary.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_SetAuthorA (TPtxPdf_Metadata *pMetadata, const char *szAuthor)
 The name of the person who created the document or resource. This property corresponds to the "dc:creator" entry in the XMP metadata and to the "Author" entry in the document information dictionary.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_SetAuthorW (TPtxPdf_Metadata *pMetadata, const WCHAR *szAuthor)
 The name of the person who created the document or resource. This property corresponds to the "dc:creator" entry in the XMP metadata and to the "Author" entry in the document information dictionary.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetSubjectA (TPtxPdf_Metadata *pMetadata, char *pBuffer, size_t nBufferSize)
 The subject of the document or resource. This property corresponds to the "dc:description" entry in the XMP metadata and to the "Subject" entry in the document information dictionary.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetSubjectW (TPtxPdf_Metadata *pMetadata, WCHAR *pBuffer, size_t nBufferSize)
 The subject of the document or resource. This property corresponds to the "dc:description" entry in the XMP metadata and to the "Subject" entry in the document information dictionary.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_SetSubjectA (TPtxPdf_Metadata *pMetadata, const char *szSubject)
 The subject of the document or resource. This property corresponds to the "dc:description" entry in the XMP metadata and to the "Subject" entry in the document information dictionary.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_SetSubjectW (TPtxPdf_Metadata *pMetadata, const WCHAR *szSubject)
 The subject of the document or resource. This property corresponds to the "dc:description" entry in the XMP metadata and to the "Subject" entry in the document information dictionary.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetKeywordsA (TPtxPdf_Metadata *pMetadata, char *pBuffer, size_t nBufferSize)
 Keywords associated with the document or resource.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetKeywordsW (TPtxPdf_Metadata *pMetadata, WCHAR *pBuffer, size_t nBufferSize)
 Keywords associated with the document or resource.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_SetKeywordsA (TPtxPdf_Metadata *pMetadata, const char *szKeywords)
 Keywords associated with the document or resource.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_SetKeywordsW (TPtxPdf_Metadata *pMetadata, const WCHAR *szKeywords)
 Keywords associated with the document or resource.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetCreatorA (TPtxPdf_Metadata *pMetadata, char *pBuffer, size_t nBufferSize)
 The original application that created the document.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetCreatorW (TPtxPdf_Metadata *pMetadata, WCHAR *pBuffer, size_t nBufferSize)
 The original application that created the document.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_SetCreatorA (TPtxPdf_Metadata *pMetadata, const char *szCreator)
 The original application that created the document.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_SetCreatorW (TPtxPdf_Metadata *pMetadata, const WCHAR *szCreator)
 The original application that created the document.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetProducerA (TPtxPdf_Metadata *pMetadata, char *pBuffer, size_t nBufferSize)
 The application that created the PDF.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetProducerW (TPtxPdf_Metadata *pMetadata, WCHAR *pBuffer, size_t nBufferSize)
 The application that created the PDF.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetCreationDate (TPtxPdf_Metadata *pMetadata, TPtxSys_Date *pCreationDate)
 The date and time the document or resource was originally created. This property corresponds to the "xmp:CreateDate" entry in the XMP metadata and to the "CreationDate" entry in the document information dictionary.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_SetCreationDate (TPtxPdf_Metadata *pMetadata, const TPtxSys_Date *pCreationDate)
 The date and time the document or resource was originally created. This property corresponds to the "xmp:CreateDate" entry in the XMP metadata and to the "CreationDate" entry in the document information dictionary.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetModificationDate (TPtxPdf_Metadata *pMetadata, TPtxSys_Date *pModificationDate)
 The date and time the document or resource was most recently modified. This property corresponds to the "xmp:ModifyDate" entry in the XMP metadata and to the "ModDate" entry in the document information dictionary.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetXmp (TPtxPdf_Metadata *pMetadata, TPtxSys_StreamDescriptor *pOutStreamDesc)
 The XMP metadata.
 
PDFTOOLS_TOOLBOX_EXPORT TPtx_StringMap *PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetCustomEntries (TPtxPdf_Metadata *pMetadata)
 The custom entries in the document information dictionary.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_FileReference *PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_CreateA (TPtxPdf_Document *pTargetDocument, const TPtxSys_StreamDescriptor *pData, const char *szName, const char *szMediaType, const char *szDescription, const TPtxSys_Date *pModificationDate)
 Create a new file reference object The newly created file reference object belongs to the document but is not (yet) used as an embedded file. The object can be added to the list of embedded files or to the list of associated files.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_FileReference *PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_CreateW (TPtxPdf_Document *pTargetDocument, const TPtxSys_StreamDescriptor *pData, const WCHAR *szName, const WCHAR *szMediaType, const WCHAR *szDescription, const TPtxSys_Date *pModificationDate)
 Create a new file reference object The newly created file reference object belongs to the document but is not (yet) used as an embedded file. The object can be added to the list of embedded files or to the list of associated files.
 
PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_FileReference *PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_Copy (TPtxPdf_Document *pTargetDocument, TPtxPdf_FileReference *pFileReference)
 Copy a file reference object Copy a file reference object from an input document to the given pTargetDocument. The returned object is associated with the given target document but not yet part of it.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_GetAssociationRelationshipA (TPtxPdf_FileReference *pFileReference, char *pBuffer, size_t nBufferSize)
 The file's association relationship This property is NULL if the file is not associated with any object. When associating a file reference with an object such as the document or a page, then this property defines the relationship between the file and the object. Typical values are:
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_GetAssociationRelationshipW (TPtxPdf_FileReference *pFileReference, WCHAR *pBuffer, size_t nBufferSize)
 The file's association relationship This property is NULL if the file is not associated with any object. When associating a file reference with an object such as the document or a page, then this property defines the relationship between the file and the object. Typical values are:
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_SetAssociationRelationshipA (TPtxPdf_FileReference *pFileReference, const char *szAssociationRelationship)
 The file's association relationship This property is NULL if the file is not associated with any object. When associating a file reference with an object such as the document or a page, then this property defines the relationship between the file and the object. Typical values are:
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_SetAssociationRelationshipW (TPtxPdf_FileReference *pFileReference, const WCHAR *szAssociationRelationship)
 The file's association relationship This property is NULL if the file is not associated with any object. When associating a file reference with an object such as the document or a page, then this property defines the relationship between the file and the object. Typical values are:
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_GetDescriptionA (TPtxPdf_FileReference *pFileReference, char *pBuffer, size_t nBufferSize)
 The file's description For embedded files, this is the description of the file presented to the user in the list of embedded files.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_GetDescriptionW (TPtxPdf_FileReference *pFileReference, WCHAR *pBuffer, size_t nBufferSize)
 The file's description For embedded files, this is the description of the file presented to the user in the list of embedded files.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_GetMediaTypeA (TPtxPdf_FileReference *pFileReference, char *pBuffer, size_t nBufferSize)
 The file's MIME type.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_GetMediaTypeW (TPtxPdf_FileReference *pFileReference, WCHAR *pBuffer, size_t nBufferSize)
 The file's MIME type.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_GetModificationDate (TPtxPdf_FileReference *pFileReference, TPtxSys_Date *pModificationDate)
 The file's date of last modification.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_GetNameA (TPtxPdf_FileReference *pFileReference, char *pBuffer, size_t nBufferSize)
 The file name For embedded files, this is the name presented to the user in a the list of embedded files.
 
PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_GetNameW (TPtxPdf_FileReference *pFileReference, WCHAR *pBuffer, size_t nBufferSize)
 The file name For embedded files, this is the name presented to the user in a the list of embedded files.
 
PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_GetData (TPtxPdf_FileReference *pFileReference, TPtxSys_StreamDescriptor *pOutStreamDesc)
 The file's stream.
 

Macro Definition Documentation

◆ PDFTOOLS_TOOLBOX_CALL

#define PDFTOOLS_TOOLBOX_CALL

◆ PtxPdf_Document_GetLanguage

#define PtxPdf_Document_GetLanguage   PtxPdf_Document_GetLanguageA

◆ PtxPdf_Document_Open

#define PtxPdf_Document_Open   PtxPdf_Document_OpenA

◆ PtxPdf_Document_OpenWithFdf

#define PtxPdf_Document_OpenWithFdf   PtxPdf_Document_OpenWithFdfA

◆ PtxPdf_Document_SetLanguage

#define PtxPdf_Document_SetLanguage   PtxPdf_Document_SetLanguageA

◆ PtxPdf_Encryption_GetOwnerPassword

#define PtxPdf_Encryption_GetOwnerPassword   PtxPdf_Encryption_GetOwnerPasswordA

◆ PtxPdf_Encryption_GetUserPassword

#define PtxPdf_Encryption_GetUserPassword   PtxPdf_Encryption_GetUserPasswordA

◆ PtxPdf_Encryption_New

#define PtxPdf_Encryption_New   PtxPdf_Encryption_NewA

◆ PtxPdf_Encryption_SetOwnerPassword

#define PtxPdf_Encryption_SetOwnerPassword   PtxPdf_Encryption_SetOwnerPasswordA

◆ PtxPdf_Encryption_SetUserPassword

#define PtxPdf_Encryption_SetUserPassword   PtxPdf_Encryption_SetUserPasswordA

◆ PtxPdf_FileReference_Create

#define PtxPdf_FileReference_Create   PtxPdf_FileReference_CreateA

◆ PtxPdf_FileReference_GetAssociationRelationship

#define PtxPdf_FileReference_GetAssociationRelationship   PtxPdf_FileReference_GetAssociationRelationshipA

◆ PtxPdf_FileReference_GetDescription

#define PtxPdf_FileReference_GetDescription   PtxPdf_FileReference_GetDescriptionA

◆ PtxPdf_FileReference_GetMediaType

#define PtxPdf_FileReference_GetMediaType   PtxPdf_FileReference_GetMediaTypeA

◆ PtxPdf_FileReference_GetName

#define PtxPdf_FileReference_GetName   PtxPdf_FileReference_GetNameA

◆ PtxPdf_FileReference_SetAssociationRelationship

#define PtxPdf_FileReference_SetAssociationRelationship   PtxPdf_FileReference_SetAssociationRelationshipA

◆ PtxPdf_Metadata_GetAuthor

#define PtxPdf_Metadata_GetAuthor   PtxPdf_Metadata_GetAuthorA

◆ PtxPdf_Metadata_GetCreator

#define PtxPdf_Metadata_GetCreator   PtxPdf_Metadata_GetCreatorA

◆ PtxPdf_Metadata_GetKeywords

#define PtxPdf_Metadata_GetKeywords   PtxPdf_Metadata_GetKeywordsA

◆ PtxPdf_Metadata_GetProducer

#define PtxPdf_Metadata_GetProducer   PtxPdf_Metadata_GetProducerA

◆ PtxPdf_Metadata_GetSubject

#define PtxPdf_Metadata_GetSubject   PtxPdf_Metadata_GetSubjectA

◆ PtxPdf_Metadata_GetTitle

#define PtxPdf_Metadata_GetTitle   PtxPdf_Metadata_GetTitleA

◆ PtxPdf_Metadata_SetAuthor

#define PtxPdf_Metadata_SetAuthor   PtxPdf_Metadata_SetAuthorA

◆ PtxPdf_Metadata_SetCreator

#define PtxPdf_Metadata_SetCreator   PtxPdf_Metadata_SetCreatorA

◆ PtxPdf_Metadata_SetKeywords

#define PtxPdf_Metadata_SetKeywords   PtxPdf_Metadata_SetKeywordsA

◆ PtxPdf_Metadata_SetSubject

#define PtxPdf_Metadata_SetSubject   PtxPdf_Metadata_SetSubjectA

◆ PtxPdf_Metadata_SetTitle

#define PtxPdf_Metadata_SetTitle   PtxPdf_Metadata_SetTitleA

◆ PtxPdf_OptionalContentGroup_GetName

#define PtxPdf_OptionalContentGroup_GetName   PtxPdf_OptionalContentGroup_GetNameA

◆ PtxPdf_Page_GetPageLabel

#define PtxPdf_Page_GetPageLabel   PtxPdf_Page_GetPageLabelA

Function Documentation

◆ PtxPdf_Document_Close()

Close object.

Close disposable objects by invoking this function.

Parameters
[in]pObjectDisposable object.
Returns
TRUE if the object was closed successfully; FALSE if an error occured while closing the object. Retrieve the error code by calling Ptx_GetLastError .

◆ PtxPdf_Document_Create()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Document *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_Create ( const TPtxSys_StreamDescriptor * pStreamDesc,
const TPtxPdf_Conformance * pConformance,
TPtxPdf_Encryption * pEncryption )

Create a new PDF document. Documents with created with this method are writable and can be modified.

Parameters
[in,out]pStreamDescThe stream where the PDF document is stored. Both, read and write access is required.
[in]pConformanceThe required conformance level of the PDF document. Adding pages or content from incompatible documents or using incompatible features will lead to a conformance error. When using NULL, the conformance is determined automatically, based on the conformance of the input documents and the requirements of the used features. Note that for PDF/A document it is highly recommended to set an output intent using PtxPdf_Document_SetOutputIntent.
[in,out]pEncryptionthe optional encryption parameters
Returns
the newly created document instance

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:
  • ePtx_Error_IO Error writing to the stream.
  • ePtx_Error_Conformance If the conformance level is lower than 1.7 and Unicode passwords are specified. In this context "a Unicode password" is essentially one containing characters that are not in the Windows ANSI encoding (Windows Code Page 1252).

◆ PtxPdf_Document_CreateWithFdf()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Document *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_CreateWithFdf ( const TPtxSys_StreamDescriptor * pPdfStreamDesc,
const TPtxSys_StreamDescriptor * pFdfStreamDesc,
const TPtxPdf_Conformance * pConformance,
TPtxPdf_Encryption * pEncryption )

Create a new PDF document and an associated FDF. Documents with created with this method are writable and can be modified. When creating a document with this method, all TPtxPdfAnnots_MarkupAnnotations - created or copied - are stored as an FDF file to the pFdfStreamDesc. In the output PDF (pPdfStreamDesc), only annotations that are not TPtxPdfAnnots_MarkupAnnotations are stored.

Parameters
[in,out]pPdfStreamDescThe stream where the PDF document is stored. Both, read and write access is required. The resulting PDF document contains no TPtxPdfAnnots_MarkupAnnotations.
[in,out]pFdfStreamDescThe stream where the document's TPtxPdfAnnots_MarkupAnnotations are stored in the FDF format. Both, read and write access is required.
[in]pConformanceThe required conformance level of the PDF document. Adding pages or content from incompatible documents or using incompatible features will lead to a conformance error. When using NULL, the conformance is determined automatically, based on the conformance of the input documents and the requirements of the used features. Note that for PDF/A document it is highly recommended to set an output intent using PtxPdf_Document_SetOutputIntent.
[in,out]pEncryptionthe optional encryption parameters
Returns
the newly created document instance

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:
  • ePtx_Error_IO Error writing to the pPdfStreamDesc
  • ePtx_Error_Conformance If the conformance level is lower than 1.7 and Unicode passwords are specified. In this context "a Unicode password" is essentially one containing characters that are not in the Windows ANSI encoding (Windows Code Page 1252).

◆ PtxPdf_Document_GetAllEmbeddedFiles()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_FileReferenceList *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetAllEmbeddedFiles ( TPtxPdf_Document * pDocument)

plain embedded, associated, and attached files

This read-only list contains the union of all plain embedded files, associated files, and files contained in file attachment annotations. This is the list of files contained in a PDF as presented in a PDF viewer.

This list does not support appending.

Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_GetAssociatedFiles()

document-associated files

This list contains associated files, whose associated object is the document.

If the document is writable, then it is possible to append new file references to the list. Every file reference object can occur at most once in this list.

Appending to this list results in a Conformance error if the document's conformance is neither PDF/A-3 nor can be upgraded to PDF 2.0.

Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_GetConformance()

the claimed conformance of the document. This method only returns the claimed conformance level, the document is not validated.

Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_GetFormFields()

The form fields of the document This list contains all AcroForm form fields that belong to this document. Adding to this list results in an error:

  • IllegalState if the list has already been closed
  • UnsupportedOperation if the document is read-only
  • IllegalArgument
    • if the given form field node is NULL
    • if the given form field node has already been closed
    • if the given form field node does not belong to the same document as the list
    • if the given form field node has already been added to a form field node list
    • if the given form field node's identifier equals an identifier of one of the form field nodes in this list This list does not support removing elements or setting elements or clearing.
Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_GetLanguageA()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetLanguageA ( TPtxPdf_Document * pDocument,
char * pBuffer,
size_t nBufferSize )

the default language for the document. A language identifier specifying the natural language for all text in the document except where overridden by language specifications for structure elements or marked content. If this entry is absent, the language is considered unknown.

Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_GetLanguageW()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetLanguageW ( TPtxPdf_Document * pDocument,
WCHAR * pBuffer,
size_t nBufferSize )

the default language for the document. A language identifier specifying the natural language for all text in the document except where overridden by language specifications for structure elements or marked content. If this entry is absent, the language is considered unknown.

Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_GetMetadata()

the metadata of the document. If the document is writable, the metadata object will be writable too and all changes to the metadata object are reflected in the document.

Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_GetOpenDestination()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdfNav_Destination *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetOpenDestination ( TPtxPdf_Document * pDocument)

The destination that is displayed when the document is opened.

Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
Returns
Retrieved value.

NULL if either an error occurred or the returned object is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.

Note
An error occurred when NULL was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_GetOptionalContentGroups()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_OptionalContentGroupList *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetOptionalContentGroups ( TPtxPdf_Document * pDocument)

The optional content groups (layers) of the document.

Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_GetOutline()

The document outline, also known as "Bookmarks".

Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_GetOutputIntent()

the output intent of the document. The output intent specifies a color profile that characterizes the intended output device. It is used to render device colors on devices other than the intended output device.

Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
Returns
Retrieved value.

NULL if either an error occurred or the returned object is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.

Note
An error occurred when NULL was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_GetPages()

the pages of the document. If the document is writable, it is possible to append new pages to the end of the list.

Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_GetPermissions()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetPermissions ( TPtxPdf_Document * pDocument,
TPtxPdf_Permission * pPermissions )

The permissions in force for this document. This property is NULL if the document is not encrypted.

Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
[out]pPermissionsRetrieved value.
Returns
FALSE if either an error occurred or the [out] argument returns NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_GetPlainEmbeddedFiles()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_FileReferenceList *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_GetPlainEmbeddedFiles ( TPtxPdf_Document * pDocument)

plain embedded files

This list contains plain embedded files, i.e., files that are embedded in this document without having a specific association (PtxPdf_Document_GetAssociatedFiles), and without being contained in any TPtxPdfAnnots_FileAttachment.

If the document is writable, then it is possible to append new file references to the list. Every file reference object can occur at most once in this list.

For PDF/A-3 documents, appending to this list results in a Conformance error.

Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_GetSignatureFields()

The signature fields of the document Signature fields are a special kind of form fields, that can contain digital signatures.

Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_GetViewerSettings()

The settings to use when opening the document in a viewer.

Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_IsLinearized()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_IsLinearized ( TPtxPdf_Document * pDocument)

Whether the document is linearized.

Linearization is also known as "Fast Web View" and is a way of optimizing PDFs so they can be streamed into a client application. This helps online documents open almost instantly, without having to wait for a large document to completely download.

Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_OpenA()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Document *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_OpenA ( const TPtxSys_StreamDescriptor * pStreamDesc,
const char * szPassword )

Open a PDF document. Documents opened with this method are read-only and cannot be modified.

Parameters
[in]pStreamDescThe stream where the PDF document is stored. Read access is required.
[in]szPasswordthe password to open the PDF document
Returns
the newly created document instance

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_OpenW()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Document *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_OpenW ( const TPtxSys_StreamDescriptor * pStreamDesc,
const WCHAR * szPassword )

Open a PDF document. Documents opened with this method are read-only and cannot be modified.

Parameters
[in]pStreamDescThe stream where the PDF document is stored. Read access is required.
[in]szPasswordthe password to open the PDF document
Returns
the newly created document instance

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_OpenWithFdfA()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Document *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_OpenWithFdfA ( const TPtxSys_StreamDescriptor * pPdfStreamDesc,
const TPtxSys_StreamDescriptor * pFdfStreamDesc,
const char * szPassword )

Open a PDF document together with an FDF file. Documents opened with this method are read-only and cannot be modified.

Parameters
[in]pPdfStreamDescThe stream where the PDF document is stored. Read access is required.
[in]pFdfStreamDescThe stream where the FDF file is stored. Read access is required.
[in]szPasswordthe password to open the PDF document
Returns
the newly created document instance

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_OpenWithFdfW()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Document *PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_OpenWithFdfW ( const TPtxSys_StreamDescriptor * pPdfStreamDesc,
const TPtxSys_StreamDescriptor * pFdfStreamDesc,
const WCHAR * szPassword )

Open a PDF document together with an FDF file. Documents opened with this method are read-only and cannot be modified.

Parameters
[in]pPdfStreamDescThe stream where the PDF document is stored. Read access is required.
[in]pFdfStreamDescThe stream where the FDF file is stored. Read access is required.
[in]szPasswordthe password to open the PDF document
Returns
the newly created document instance

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_SetLanguageA()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_SetLanguageA ( TPtxPdf_Document * pDocument,
const char * szLanguage )

the default language for the document. A language identifier specifying the natural language for all text in the document except where overridden by language specifications for structure elements or marked content. If this entry is absent, the language is considered unknown.

Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
[in]szLanguageSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_SetLanguageW()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_SetLanguageW ( TPtxPdf_Document * pDocument,
const WCHAR * szLanguage )

the default language for the document. A language identifier specifying the natural language for all text in the document except where overridden by language specifications for structure elements or marked content. If this entry is absent, the language is considered unknown.

Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
[in]szLanguageSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_SetMetadata()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_SetMetadata ( TPtxPdf_Document * pDocument,
TPtxPdf_Metadata * pMetadata )

the metadata of the document. If the document is writable, the metadata object will be writable too and all changes to the metadata object are reflected in the document.

Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
[in,out]pMetadataSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_SetOpenDestination()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_SetOpenDestination ( TPtxPdf_Document * pDocument,
TPtxPdfNav_Destination * pOpenDestination )

The destination that is displayed when the document is opened.

Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
[in,out]pOpenDestinationSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_SetOutputIntent()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_SetOutputIntent ( TPtxPdf_Document * pDocument,
TPtxPdfContent_IccBasedColorSpace * pOutputIntent )

the output intent of the document. The output intent specifies a color profile that characterizes the intended output device. It is used to render device colors on devices other than the intended output device.

Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
[in,out]pOutputIntentSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Document_SetViewerSettings()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Document_SetViewerSettings ( TPtxPdf_Document * pDocument,
TPtxPdfNav_ViewerSettings * pViewerSettings )

The settings to use when opening the document in a viewer.

Parameters
[in,out]pDocumentActs as a handle to the native object of type TPtxPdf_Document.
[in,out]pViewerSettingsSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Encryption_GetOwnerPasswordA()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_GetOwnerPasswordA ( TPtxPdf_Encryption * pEncryption,
char * pBuffer,
size_t nBufferSize )

The owner password opens the document with no access restrictions.

Parameters
[in,out]pEncryptionActs as a handle to the native object of type TPtxPdf_Encryption.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_Encryption_GetOwnerPasswordW()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_GetOwnerPasswordW ( TPtxPdf_Encryption * pEncryption,
WCHAR * pBuffer,
size_t nBufferSize )

The owner password opens the document with no access restrictions.

Parameters
[in,out]pEncryptionActs as a handle to the native object of type TPtxPdf_Encryption.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_Encryption_GetPermissions()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Permission PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_GetPermissions ( TPtxPdf_Encryption * pEncryption)

The permissions that will be granted to a user who opens the document using the PtxPdf_Encryption_GetUserPassword. The value is either null (all permissions), or a concatenation of the allowed TPtxPdf_Permission values.

Parameters
[in,out]pEncryptionActs as a handle to the native object of type TPtxPdf_Encryption.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_Encryption_GetUserPasswordA()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_GetUserPasswordA ( TPtxPdf_Encryption * pEncryption,
char * pBuffer,
size_t nBufferSize )

The user password opens the document with the permissions defined by the PtxPdf_Encryption_GetPermissions parameter.

Parameters
[in,out]pEncryptionActs as a handle to the native object of type TPtxPdf_Encryption.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_Encryption_GetUserPasswordW()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_GetUserPasswordW ( TPtxPdf_Encryption * pEncryption,
WCHAR * pBuffer,
size_t nBufferSize )

The user password opens the document with the permissions defined by the PtxPdf_Encryption_GetPermissions parameter.

Parameters
[in,out]pEncryptionActs as a handle to the native object of type TPtxPdf_Encryption.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_Encryption_NewA()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Encryption *PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_NewA ( const char * szUserPassword,
const char * szOwnerPassword,
TPtxPdf_Permission iPermissions )

The PtxPdf_Encryption_GetUserPassword may be used to open the document with the permissions defined by the PtxPdf_Encryption_GetPermissions parameter. The PtxPdf_Encryption_GetOwnerPassword may be used to open the document with no access restrictions. The PtxPdf_Encryption_GetPermissions may be NULL (all permissions), or a concatenation of the allowed TPtxPdf_Permission values.

Parameters
[in]szUserPassword
[in]szOwnerPassword
[in]iPermissions
Returns
Handle to the newly created native object.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_Encryption_NewW()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Encryption *PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_NewW ( const WCHAR * szUserPassword,
const WCHAR * szOwnerPassword,
TPtxPdf_Permission iPermissions )

The PtxPdf_Encryption_GetUserPassword may be used to open the document with the permissions defined by the PtxPdf_Encryption_GetPermissions parameter. The PtxPdf_Encryption_GetOwnerPassword may be used to open the document with no access restrictions. The PtxPdf_Encryption_GetPermissions may be NULL (all permissions), or a concatenation of the allowed TPtxPdf_Permission values.

Parameters
[in]szUserPassword
[in]szOwnerPassword
[in]iPermissions
Returns
Handle to the newly created native object.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_Encryption_SetOwnerPasswordA()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_SetOwnerPasswordA ( TPtxPdf_Encryption * pEncryption,
const char * szOwnerPassword )

The owner password opens the document with no access restrictions.

Parameters
[in,out]pEncryptionActs as a handle to the native object of type TPtxPdf_Encryption.
[in]szOwnerPasswordSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_Encryption_SetOwnerPasswordW()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_SetOwnerPasswordW ( TPtxPdf_Encryption * pEncryption,
const WCHAR * szOwnerPassword )

The owner password opens the document with no access restrictions.

Parameters
[in,out]pEncryptionActs as a handle to the native object of type TPtxPdf_Encryption.
[in]szOwnerPasswordSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_Encryption_SetPermissions()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_SetPermissions ( TPtxPdf_Encryption * pEncryption,
TPtxPdf_Permission iPermissions )

The permissions that will be granted to a user who opens the document using the PtxPdf_Encryption_GetUserPassword. The value is either null (all permissions), or a concatenation of the allowed TPtxPdf_Permission values.

Parameters
[in,out]pEncryptionActs as a handle to the native object of type TPtxPdf_Encryption.
[in]iPermissionsSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_Encryption_SetUserPasswordA()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_SetUserPasswordA ( TPtxPdf_Encryption * pEncryption,
const char * szUserPassword )

The user password opens the document with the permissions defined by the PtxPdf_Encryption_GetPermissions parameter.

Parameters
[in,out]pEncryptionActs as a handle to the native object of type TPtxPdf_Encryption.
[in]szUserPasswordSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_Encryption_SetUserPasswordW()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Encryption_SetUserPasswordW ( TPtxPdf_Encryption * pEncryption,
const WCHAR * szUserPassword )

The user password opens the document with the permissions defined by the PtxPdf_Encryption_GetPermissions parameter.

Parameters
[in,out]pEncryptionActs as a handle to the native object of type TPtxPdf_Encryption.
[in]szUserPasswordSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_FileReference_Copy()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_FileReference *PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_Copy ( TPtxPdf_Document * pTargetDocument,
TPtxPdf_FileReference * pFileReference )

Copy a file reference object Copy a file reference object from an input document to the given pTargetDocument. The returned object is associated with the given target document but not yet part of it.

Parameters
[in,out]pTargetDocumentthe output document with which the returned object is associated
[in,out]pFileReferencea file reference object of a different document
Returns
the copied file reference, associated with the current document

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_FileReference_CreateA()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_FileReference *PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_CreateA ( TPtxPdf_Document * pTargetDocument,
const TPtxSys_StreamDescriptor * pData,
const char * szName,
const char * szMediaType,
const char * szDescription,
const TPtxSys_Date * pModificationDate )

Create a new file reference object The newly created file reference object belongs to the document but is not (yet) used as an embedded file. The object can be added to the list of embedded files or to the list of associated files.

Parameters
[in,out]pTargetDocumentthe output document with which the returned object is associated
[in]pDataA stream of the file to be added. Read access is required.
[in]szNameThe name to be used for the embedded file. This name is presented to the user when viewing the list of embedded files.
[in]szMediaTypeThe mime type of the embedded file. Default: "application/octet-stream". Common values other than the default are "application/pdf", "application/xml", or "application/msword".
[in]szDescriptionThe description of the embedded file. This is presented to the user when viewing the list of embedded files.
[in]pModificationDateThe modify date of the file. Default: current time.
Returns
the newly created file reference object

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_FileReference_CreateW()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_FileReference *PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_CreateW ( TPtxPdf_Document * pTargetDocument,
const TPtxSys_StreamDescriptor * pData,
const WCHAR * szName,
const WCHAR * szMediaType,
const WCHAR * szDescription,
const TPtxSys_Date * pModificationDate )

Create a new file reference object The newly created file reference object belongs to the document but is not (yet) used as an embedded file. The object can be added to the list of embedded files or to the list of associated files.

Parameters
[in,out]pTargetDocumentthe output document with which the returned object is associated
[in]pDataA stream of the file to be added. Read access is required.
[in]szNameThe name to be used for the embedded file. This name is presented to the user when viewing the list of embedded files.
[in]szMediaTypeThe mime type of the embedded file. Default: "application/octet-stream". Common values other than the default are "application/pdf", "application/xml", or "application/msword".
[in]szDescriptionThe description of the embedded file. This is presented to the user when viewing the list of embedded files.
[in]pModificationDateThe modify date of the file. Default: current time.
Returns
the newly created file reference object

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_FileReference_GetAssociationRelationshipA()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_GetAssociationRelationshipA ( TPtxPdf_FileReference * pFileReference,
char * pBuffer,
size_t nBufferSize )

The file's association relationship This property is NULL if the file is not associated with any object. When associating a file reference with an object such as the document or a page, then this property defines the relationship between the file and the object. Typical values are:

  • "Source": used if this file is the original source material for the associated content.
  • "Data": used if this file represents information used to derive a visual presentation such as for a table or a graph.
  • "Alternative": used if this file is an alternative representation of content, for example audio.
  • "Supplement": used if this file represents a supplemental representation of the original source or data that may be more easily consumable (e.g., a MathML version of an equation).
  • "EncryptedPayload": used if this file 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.
  • "FormData": used if this file is the data associated with form fields of this PDF.
  • "Schema": used if this file is a schema definition for the associated object.
  • "Unspecified": used when the relationship is not known.
Parameters
[in,out]pFileReferenceActs as a handle to the native object of type TPtxPdf_FileReference.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_FileReference_GetAssociationRelationshipW()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_GetAssociationRelationshipW ( TPtxPdf_FileReference * pFileReference,
WCHAR * pBuffer,
size_t nBufferSize )

The file's association relationship This property is NULL if the file is not associated with any object. When associating a file reference with an object such as the document or a page, then this property defines the relationship between the file and the object. Typical values are:

  • "Source": used if this file is the original source material for the associated content.
  • "Data": used if this file represents information used to derive a visual presentation such as for a table or a graph.
  • "Alternative": used if this file is an alternative representation of content, for example audio.
  • "Supplement": used if this file represents a supplemental representation of the original source or data that may be more easily consumable (e.g., a MathML version of an equation).
  • "EncryptedPayload": used if this file 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.
  • "FormData": used if this file is the data associated with form fields of this PDF.
  • "Schema": used if this file is a schema definition for the associated object.
  • "Unspecified": used when the relationship is not known.
Parameters
[in,out]pFileReferenceActs as a handle to the native object of type TPtxPdf_FileReference.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_FileReference_GetData()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_GetData ( TPtxPdf_FileReference * pFileReference,
TPtxSys_StreamDescriptor * pOutStreamDesc )

The file's stream.

Parameters
[in,out]pFileReferenceActs as a handle to the native object of type TPtxPdf_FileReference.
[out]pOutStreamDescRetrieved value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_FileReference_GetDescriptionA()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_GetDescriptionA ( TPtxPdf_FileReference * pFileReference,
char * pBuffer,
size_t nBufferSize )

The file's description For embedded files, this is the description of the file presented to the user in the list of embedded files.

Parameters
[in,out]pFileReferenceActs as a handle to the native object of type TPtxPdf_FileReference.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_FileReference_GetDescriptionW()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_GetDescriptionW ( TPtxPdf_FileReference * pFileReference,
WCHAR * pBuffer,
size_t nBufferSize )

The file's description For embedded files, this is the description of the file presented to the user in the list of embedded files.

Parameters
[in,out]pFileReferenceActs as a handle to the native object of type TPtxPdf_FileReference.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_FileReference_GetMediaTypeA()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_GetMediaTypeA ( TPtxPdf_FileReference * pFileReference,
char * pBuffer,
size_t nBufferSize )

The file's MIME type.

Parameters
[in,out]pFileReferenceActs as a handle to the native object of type TPtxPdf_FileReference.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_FileReference_GetMediaTypeW()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_GetMediaTypeW ( TPtxPdf_FileReference * pFileReference,
WCHAR * pBuffer,
size_t nBufferSize )

The file's MIME type.

Parameters
[in,out]pFileReferenceActs as a handle to the native object of type TPtxPdf_FileReference.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_FileReference_GetModificationDate()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_GetModificationDate ( TPtxPdf_FileReference * pFileReference,
TPtxSys_Date * pModificationDate )

The file's date of last modification.

Parameters
[in,out]pFileReferenceActs as a handle to the native object of type TPtxPdf_FileReference.
[out]pModificationDateRetrieved value.
Returns
FALSE if either an error occurred or the [out] argument returns NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_FileReference_GetNameA()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_GetNameA ( TPtxPdf_FileReference * pFileReference,
char * pBuffer,
size_t nBufferSize )

The file name For embedded files, this is the name presented to the user in a the list of embedded files.

Parameters
[in,out]pFileReferenceActs as a handle to the native object of type TPtxPdf_FileReference.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if there is an error.
Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_FileReference_GetNameW()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_GetNameW ( TPtxPdf_FileReference * pFileReference,
WCHAR * pBuffer,
size_t nBufferSize )

The file name For embedded files, this is the name presented to the user in a the list of embedded files.

Parameters
[in,out]pFileReferenceActs as a handle to the native object of type TPtxPdf_FileReference.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if there is an error.
Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_FileReference_SetAssociationRelationshipA()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_SetAssociationRelationshipA ( TPtxPdf_FileReference * pFileReference,
const char * szAssociationRelationship )

The file's association relationship This property is NULL if the file is not associated with any object. When associating a file reference with an object such as the document or a page, then this property defines the relationship between the file and the object. Typical values are:

  • "Source": used if this file is the original source material for the associated content.
  • "Data": used if this file represents information used to derive a visual presentation such as for a table or a graph.
  • "Alternative": used if this file is an alternative representation of content, for example audio.
  • "Supplement": used if this file represents a supplemental representation of the original source or data that may be more easily consumable (e.g., a MathML version of an equation).
  • "EncryptedPayload": used if this file 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.
  • "FormData": used if this file is the data associated with form fields of this PDF.
  • "Schema": used if this file is a schema definition for the associated object.
  • "Unspecified": used when the relationship is not known.
Parameters
[in,out]pFileReferenceActs as a handle to the native object of type TPtxPdf_FileReference.
[in]szAssociationRelationshipSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_FileReference_SetAssociationRelationshipW()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReference_SetAssociationRelationshipW ( TPtxPdf_FileReference * pFileReference,
const WCHAR * szAssociationRelationship )

The file's association relationship This property is NULL if the file is not associated with any object. When associating a file reference with an object such as the document or a page, then this property defines the relationship between the file and the object. Typical values are:

  • "Source": used if this file is the original source material for the associated content.
  • "Data": used if this file represents information used to derive a visual presentation such as for a table or a graph.
  • "Alternative": used if this file is an alternative representation of content, for example audio.
  • "Supplement": used if this file represents a supplemental representation of the original source or data that may be more easily consumable (e.g., a MathML version of an equation).
  • "EncryptedPayload": used if this file 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.
  • "FormData": used if this file is the data associated with form fields of this PDF.
  • "Schema": used if this file is a schema definition for the associated object.
  • "Unspecified": used when the relationship is not known.
Parameters
[in,out]pFileReferenceActs as a handle to the native object of type TPtxPdf_FileReference.
[in]szAssociationRelationshipSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_FileReferenceList_Add()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReferenceList_Add ( TPtxPdf_FileReferenceList * pFileReferenceList,
TPtxPdf_FileReference * pFileReference )

Add an element to the end of the list.

Parameters
[in,out]pFileReferenceListActs as a handle to the native object of type TPtxPdf_FileReferenceList.
[in,out]pFileReference
Returns
May indicate an error in certain scenarios. For further information see the note section below.
Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_FileReferenceList_Get()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_FileReference *PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReferenceList_Get ( TPtxPdf_FileReferenceList * pFileReferenceList,
int iIndex )

Returns the element at the specified position in the given list.

Parameters
[in,out]pFileReferenceListActs as a handle to the native object of type TPtxPdf_FileReferenceList.
[in]iIndex
Returns
NULL if there is an error.
Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_FileReferenceList_GetCount()

PDFTOOLS_TOOLBOX_EXPORT int PDFTOOLS_TOOLBOX_CALL PtxPdf_FileReferenceList_GetCount ( TPtxPdf_FileReferenceList * pFileReferenceList)

Get the number of elements in the list.

Parameters
[in,out]pFileReferenceListActs as a handle to the native object of type TPtxPdf_FileReferenceList.
Returns
May indicate an error in certain scenarios. For further information see the note section below.
Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_Copy()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Metadata *PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_Copy ( TPtxPdf_Document * pTargetDocument,
TPtxPdf_Metadata * pMetadata )

Copy a metadata object Copy a metadata object from an input document to the given pTargetDocument. The returned object is associated with the target document but not (yet) used as the document metadata. The object can be used either as document metadata using PtxPdf_Document_SetMetadata or as page metadata using PtxPdf_Page_SetMetadata.

Parameters
[in,out]pTargetDocumentthe output document with which the returned object is associated
[in,out]pMetadatathe metadata of a different document
Returns
a metadata object with the same content, but associated with the current document.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_Create()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Metadata *PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_Create ( TPtxPdf_Document * pTargetDocument,
const TPtxSys_StreamDescriptor * pXmp )

Create a new metadata object The newly created metadata object is associated with the target document but not (yet) used as the document metadata. The object can be used either as document metadata using PtxPdf_Document_SetMetadata or as page metadata using PtxPdf_Page_SetMetadata.

Parameters
[in,out]pTargetDocumentthe output document with which the returned object is associated
[in]pXmpA stream containing an XMP file or NULL to create an empty metadata object.
Returns
the newly created metadata object

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_GetAuthorA()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetAuthorA ( TPtxPdf_Metadata * pMetadata,
char * pBuffer,
size_t nBufferSize )

The name of the person who created the document or resource. This property corresponds to the "dc:creator" entry in the XMP metadata and to the "Author" entry in the document information dictionary.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_GetAuthorW()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetAuthorW ( TPtxPdf_Metadata * pMetadata,
WCHAR * pBuffer,
size_t nBufferSize )

The name of the person who created the document or resource. This property corresponds to the "dc:creator" entry in the XMP metadata and to the "Author" entry in the document information dictionary.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_GetCreationDate()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetCreationDate ( TPtxPdf_Metadata * pMetadata,
TPtxSys_Date * pCreationDate )

The date and time the document or resource was originally created. This property corresponds to the "xmp:CreateDate" entry in the XMP metadata and to the "CreationDate" entry in the document information dictionary.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[out]pCreationDateRetrieved value.
Returns
FALSE if either an error occurred or the [out] argument returns NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_GetCreatorA()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetCreatorA ( TPtxPdf_Metadata * pMetadata,
char * pBuffer,
size_t nBufferSize )

The original application that created the document.

The name of the first known tool used to create the document or resource.

This property corresponds to the "xmp:CreatorTool" entry in the XMP metadata and to the "Creator" entry in the document information dictionary.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_GetCreatorW()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetCreatorW ( TPtxPdf_Metadata * pMetadata,
WCHAR * pBuffer,
size_t nBufferSize )

The original application that created the document.

The name of the first known tool used to create the document or resource.

This property corresponds to the "xmp:CreatorTool" entry in the XMP metadata and to the "Creator" entry in the document information dictionary.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_GetCustomEntries()

PDFTOOLS_TOOLBOX_EXPORT TPtx_StringMap *PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetCustomEntries ( TPtxPdf_Metadata * pMetadata)

The custom entries in the document information dictionary.

The standard entries "Title", "Author", "Subject", "Keywords", "CreationDate", "ModDate", "Creator", "Producer" and "Trapped" are not included in the map. Any attempt to set a standard entry through this map will result in an error. To get or set standard entries use the corresponding properties instead.

Note: The document information dictionary has been superseded by XMP metadata and is deprecated in PDF 2.0.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_GetKeywordsA()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetKeywordsA ( TPtxPdf_Metadata * pMetadata,
char * pBuffer,
size_t nBufferSize )

Keywords associated with the document or resource.

Keywords can be separated by:

  • carriage return / line feed
  • comma
  • semicolon
  • tab
  • double space

This property corresponds to the "pdf:Keywords" entry in the XMP metadata and to the "Keywords" entry in the document information dictionary.

Setting this property also sets the XMP property dc:subject accordingly.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_GetKeywordsW()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetKeywordsW ( TPtxPdf_Metadata * pMetadata,
WCHAR * pBuffer,
size_t nBufferSize )

Keywords associated with the document or resource.

Keywords can be separated by:

  • carriage return / line feed
  • comma
  • semicolon
  • tab
  • double space

This property corresponds to the "pdf:Keywords" entry in the XMP metadata and to the "Keywords" entry in the document information dictionary.

Setting this property also sets the XMP property dc:subject accordingly.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_GetModificationDate()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetModificationDate ( TPtxPdf_Metadata * pMetadata,
TPtxSys_Date * pModificationDate )

The date and time the document or resource was most recently modified. This property corresponds to the "xmp:ModifyDate" entry in the XMP metadata and to the "ModDate" entry in the document information dictionary.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[out]pModificationDateRetrieved value.
Returns
FALSE if either an error occurred or the [out] argument returns NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_GetProducerA()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetProducerA ( TPtxPdf_Metadata * pMetadata,
char * pBuffer,
size_t nBufferSize )

The application that created the PDF.

If the document was converted to PDF from another format, the name of the PDF processor that converted it to PDF.

This property corresponds to the "pdf:Producer" entry in the XMP metadata and to the "Producer" entry in the document information dictionary.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_GetProducerW()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetProducerW ( TPtxPdf_Metadata * pMetadata,
WCHAR * pBuffer,
size_t nBufferSize )

The application that created the PDF.

If the document was converted to PDF from another format, the name of the PDF processor that converted it to PDF.

This property corresponds to the "pdf:Producer" entry in the XMP metadata and to the "Producer" entry in the document information dictionary.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_GetSubjectA()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetSubjectA ( TPtxPdf_Metadata * pMetadata,
char * pBuffer,
size_t nBufferSize )

The subject of the document or resource. This property corresponds to the "dc:description" entry in the XMP metadata and to the "Subject" entry in the document information dictionary.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_GetSubjectW()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetSubjectW ( TPtxPdf_Metadata * pMetadata,
WCHAR * pBuffer,
size_t nBufferSize )

The subject of the document or resource. This property corresponds to the "dc:description" entry in the XMP metadata and to the "Subject" entry in the document information dictionary.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_GetTitleA()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetTitleA ( TPtxPdf_Metadata * pMetadata,
char * pBuffer,
size_t nBufferSize )

The title of the document or resource. This property corresponds to the "dc:title" entry in the XMP metadata and to the "Title" entry in the document information dictionary.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_GetTitleW()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetTitleW ( TPtxPdf_Metadata * pMetadata,
WCHAR * pBuffer,
size_t nBufferSize )

The title of the document or resource. This property corresponds to the "dc:title" entry in the XMP metadata and to the "Title" entry in the document information dictionary.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if either an error occurred or the returned buffer is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when 0 was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_GetXmp()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_GetXmp ( TPtxPdf_Metadata * pMetadata,
TPtxSys_StreamDescriptor * pOutStreamDesc )

The XMP metadata.

The XMP metadata stream or NULL if there is none.

The stream is read-only. To set the XMP stream of a metadata object use the method Document.CreateMetadata instead.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[out]pOutStreamDescRetrieved value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_SetAuthorA()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_SetAuthorA ( TPtxPdf_Metadata * pMetadata,
const char * szAuthor )

The name of the person who created the document or resource. This property corresponds to the "dc:creator" entry in the XMP metadata and to the "Author" entry in the document information dictionary.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[in]szAuthorSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_SetAuthorW()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_SetAuthorW ( TPtxPdf_Metadata * pMetadata,
const WCHAR * szAuthor )

The name of the person who created the document or resource. This property corresponds to the "dc:creator" entry in the XMP metadata and to the "Author" entry in the document information dictionary.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[in]szAuthorSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_SetCreationDate()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_SetCreationDate ( TPtxPdf_Metadata * pMetadata,
const TPtxSys_Date * pCreationDate )

The date and time the document or resource was originally created. This property corresponds to the "xmp:CreateDate" entry in the XMP metadata and to the "CreationDate" entry in the document information dictionary.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[in]pCreationDateSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_SetCreatorA()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_SetCreatorA ( TPtxPdf_Metadata * pMetadata,
const char * szCreator )

The original application that created the document.

The name of the first known tool used to create the document or resource.

This property corresponds to the "xmp:CreatorTool" entry in the XMP metadata and to the "Creator" entry in the document information dictionary.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[in]szCreatorSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_SetCreatorW()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_SetCreatorW ( TPtxPdf_Metadata * pMetadata,
const WCHAR * szCreator )

The original application that created the document.

The name of the first known tool used to create the document or resource.

This property corresponds to the "xmp:CreatorTool" entry in the XMP metadata and to the "Creator" entry in the document information dictionary.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[in]szCreatorSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_SetKeywordsA()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_SetKeywordsA ( TPtxPdf_Metadata * pMetadata,
const char * szKeywords )

Keywords associated with the document or resource.

Keywords can be separated by:

  • carriage return / line feed
  • comma
  • semicolon
  • tab
  • double space

This property corresponds to the "pdf:Keywords" entry in the XMP metadata and to the "Keywords" entry in the document information dictionary.

Setting this property also sets the XMP property dc:subject accordingly.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[in]szKeywordsSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_SetKeywordsW()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_SetKeywordsW ( TPtxPdf_Metadata * pMetadata,
const WCHAR * szKeywords )

Keywords associated with the document or resource.

Keywords can be separated by:

  • carriage return / line feed
  • comma
  • semicolon
  • tab
  • double space

This property corresponds to the "pdf:Keywords" entry in the XMP metadata and to the "Keywords" entry in the document information dictionary.

Setting this property also sets the XMP property dc:subject accordingly.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[in]szKeywordsSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_SetSubjectA()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_SetSubjectA ( TPtxPdf_Metadata * pMetadata,
const char * szSubject )

The subject of the document or resource. This property corresponds to the "dc:description" entry in the XMP metadata and to the "Subject" entry in the document information dictionary.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[in]szSubjectSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_SetSubjectW()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_SetSubjectW ( TPtxPdf_Metadata * pMetadata,
const WCHAR * szSubject )

The subject of the document or resource. This property corresponds to the "dc:description" entry in the XMP metadata and to the "Subject" entry in the document information dictionary.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[in]szSubjectSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_SetTitleA()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_SetTitleA ( TPtxPdf_Metadata * pMetadata,
const char * szTitle )

The title of the document or resource. This property corresponds to the "dc:title" entry in the XMP metadata and to the "Title" entry in the document information dictionary.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[in]szTitleSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Metadata_SetTitleW()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Metadata_SetTitleW ( TPtxPdf_Metadata * pMetadata,
const WCHAR * szTitle )

The title of the document or resource. This property corresponds to the "dc:title" entry in the XMP metadata and to the "Title" entry in the document information dictionary.

Parameters
[in,out]pMetadataActs as a handle to the native object of type TPtxPdf_Metadata.
[in]szTitleSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_OptionalContentGroup_GetNameA()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_OptionalContentGroup_GetNameA ( TPtxPdf_OptionalContentGroup * pOptionalContentGroup,
char * pBuffer,
size_t nBufferSize )

The name of the OCG. It can be used to identify OCGs, although it is not necessarily unique.

Parameters
[in,out]pOptionalContentGroupActs as a handle to the native object of type TPtxPdf_OptionalContentGroup.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if there is an error.
Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_OptionalContentGroup_GetNameW()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_OptionalContentGroup_GetNameW ( TPtxPdf_OptionalContentGroup * pOptionalContentGroup,
WCHAR * pBuffer,
size_t nBufferSize )

The name of the OCG. It can be used to identify OCGs, although it is not necessarily unique.

Parameters
[in,out]pOptionalContentGroupActs as a handle to the native object of type TPtxPdf_OptionalContentGroup.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if there is an error.
Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_OptionalContentGroup_GetState()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_OcgState PDFTOOLS_TOOLBOX_CALL PtxPdf_OptionalContentGroup_GetState ( TPtxPdf_OptionalContentGroup * pOptionalContentGroup)

This property is used to determine whether this OCG is ON or OFF in the default configuration.

Parameters
[in,out]pOptionalContentGroupActs as a handle to the native object of type TPtxPdf_OptionalContentGroup.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_OptionalContentGroupList_Get()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_OptionalContentGroup *PDFTOOLS_TOOLBOX_CALL PtxPdf_OptionalContentGroupList_Get ( TPtxPdf_OptionalContentGroupList * pOptionalContentGroupList,
int iIndex )

Returns the element at the specified position in the given list.

Parameters
[in,out]pOptionalContentGroupListActs as a handle to the native object of type TPtxPdf_OptionalContentGroupList.
[in]iIndex
Returns
NULL if there is an error.
Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_OptionalContentGroupList_GetCount()

PDFTOOLS_TOOLBOX_EXPORT int PDFTOOLS_TOOLBOX_CALL PtxPdf_OptionalContentGroupList_GetCount ( TPtxPdf_OptionalContentGroupList * pOptionalContentGroupList)

Get the number of elements in the list.

Parameters
[in,out]pOptionalContentGroupListActs as a handle to the native object of type TPtxPdf_OptionalContentGroupList.
Returns
May indicate an error in certain scenarios. For further information see the note section below.
Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Page_Copy()

Copy a page Copy a page object from an input document to the given pTargetDocument. The returned object is associated with the given target document but not yet part of it. It can be appended to the document's PtxPdf_Document_GetPages.

Parameters
[in,out]pTargetDocumentthe output document with which the returned object is associated
[in,out]pPagea page of a different document
[in,out]pOptionsthe copy options
Returns
the copied page, associated with the current document.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Page_Create()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Page *PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_Create ( TPtxPdf_Document * pTargetDocument,
const TPtxGeomReal_Size * pSize )

Create an empty page The page is associated with the given target document but not yet part of it. It can be appended to the document's PtxPdf_Document_GetPages.

Parameters
[in,out]pTargetDocumentthe output document with which the returned object is associated
[in]pSizethe page size
Returns
the newly created page object

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Page_GetAnnotations()

the list of this page's annotations. Adding to this list results in an error:

  • IllegalState if the list has already been closed
  • UnsupportedOperation if the document is read-only
  • IllegalArgument
    • if the given annotation is NULL
    • if the given annotation object has already been closed
    • if the given annotation does not belong to the same document as the list
    • if the given annotation is already associated with a page This list does not support removing or setting elements or clearing.
Parameters
[in,out]pPageActs as a handle to the native object of type TPtxPdf_Page.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Page_GetArtBox()

The art box of the page.

The art box (PDF 1.3) defines the extent of the page's meaningful content (including potential white-space) as intended by the page’s creator. The default value is the page's crop box.

This property is NULL if the page contains no explicit art box.

Parameters
[in,out]pPageActs as a handle to the native object of type TPtxPdf_Page.
[out]pArtBoxRetrieved value.
Returns
FALSE if either an error occurred or the [out] argument returns NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Page_GetBleedBox()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_GetBleedBox ( TPtxPdf_Page * pPage,
TPtxGeomReal_Rectangle * pBleedBox )

The bleed box of the page.

The bleed box (PDF 1.3) defines the region to which the contents of the page shall be clipped when output in a production environment. This may include any extra bleed area needed to accommodate the physical limitations of cutting, folding, and trimming equipment. The actual printed page may include printing marks that fall outside the bleed box. The default value is the page's crop box.

This property is NULL if the page contains no explicit bleed box.

Parameters
[in,out]pPageActs as a handle to the native object of type TPtxPdf_Page.
[out]pBleedBoxRetrieved value.
Returns
FALSE if either an error occurred or the [out] argument returns NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Page_GetContent()

the page content. If the page is writable, the content object can be used to apply new content on the page, for example overlays or underlays.

Parameters
[in,out]pPageActs as a handle to the native object of type TPtxPdf_Page.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Page_GetLinks()

the list of this page's links. Adding to this list results in an error:

  • IllegalState if the list has already been closed
  • UnsupportedOperation if the document is read-only
  • IllegalArgument
    • if the given link is NULL
    • if the given link object has already been closed
    • if the given link does not belong to the same document as the list
    • if the given link is already associated with a page This list does not support removing or setting elements or clearing.
Parameters
[in,out]pPageActs as a handle to the native object of type TPtxPdf_Page.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Page_GetMediaBox()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_GetMediaBox ( TPtxPdf_Page * pPage,
TPtxGeomReal_Rectangle * pMediaBox )

The media box of the page.

The media box defines the boundaries of the physical medium on which the page is to be printed. It may include any extended area surrounding the finished page for bleed, printing marks, or other such purposes. It may also include areas close to the edges of the medium that cannot be marked because of physical limitations of the output device. Content falling outside this boundary may safely be discarded without affecting the meaning of the PDF file.

This property cannot be NULL.

Parameters
[in,out]pPageActs as a handle to the native object of type TPtxPdf_Page.
[out]pMediaBoxRetrieved value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Page_GetMetadata()

the metadata of the page.

If the document is writable, the metadata object will be writable too and all changes to the metadata object are reflected in the document.

This property is NULL if the page has not metadata.

Parameters
[in,out]pPageActs as a handle to the native object of type TPtxPdf_Page.
Returns
Retrieved value.

NULL if either an error occurred or the returned object is actually NULL. To determine if an error has occurred, check the error code as described in the note section below.

Note
An error occurred when NULL was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Page_GetPageLabelA()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_GetPageLabelA ( TPtxPdf_Page * pPage,
char * pBuffer,
size_t nBufferSize )

Page label.

The label for this page. A page does not have to have a label and if it doesn't this property will be an empty string.

If it exists, a page label is designed to replace the page number in visual presentations and consists of an optional prefix and a number. Number can be in one of several styles (arabic, Roman, alphabetic) and starts at an arbitrary number for a range of pages.

Page labels are used to set distinct names or numbers, most often for preface, appendices and similar sections of the document.

Parameters
[in,out]pPageActs as a handle to the native object of type TPtxPdf_Page.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if there is an error.
Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Page_GetPageLabelW()

PDFTOOLS_TOOLBOX_EXPORT size_t PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_GetPageLabelW ( TPtxPdf_Page * pPage,
WCHAR * pBuffer,
size_t nBufferSize )

Page label.

The label for this page. A page does not have to have a label and if it doesn't this property will be an empty string.

If it exists, a page label is designed to replace the page number in visual presentations and consists of an optional prefix and a number. Number can be in one of several styles (arabic, Roman, alphabetic) and starts at an arbitrary number for a range of pages.

Page labels are used to set distinct names or numbers, most often for preface, appendices and similar sections of the document.

Parameters
[in,out]pPageActs as a handle to the native object of type TPtxPdf_Page.
[out]pBufferRetrieved value. To determine the required buffer size, the function has to be called with NULL. The return value of this function specifies the buffer size.
[in]nBufferSizeThe buffer size of the retrieved string pBuffer.
Returns
The amount of data written to the buffer pBuffer. 0 if there is an error.
Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Page_GetRotation()

The current page rotation.

Parameters
[in,out]pPageActs as a handle to the native object of type TPtxPdf_Page.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_Page_GetSize()

The visible size of the page (crop box).

The page size corresponds to the size of the crop box. Since all coordinates are normalized to the origin of the crop box, the normalized origin of the crop box is always (0,0) and thus only the size is required.

The crop box defines the region to which the contents of the page shall be clipped (cropped) when displayed or printed. Unlike the other boxes, the crop box has no defined meaning in terms of physical page geometry or intended use; it merely imposes clipping on the page contents. However, in the absence of additional information (such as imposition instructions specified in a JDF job ticket), the crop box determines how the page's contents shall be positioned on the output medium. The default value is the page's media box.

This property cannot be NULL.

Parameters
[in,out]pPageActs as a handle to the native object of type TPtxPdf_Page.
[out]pSizeRetrieved value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Page_GetTrimBox()

The trim box of the page.

The trim box (PDF 1.3) defines the intended dimensions of the finished page after trimming. It may be smaller than the media box to allow for production-related content, such as printing instructions, cut marks, or colour bars. The default value is the page's crop box.

This property is NULL if the page contains no explicit trim box.

Parameters
[in,out]pPageActs as a handle to the native object of type TPtxPdf_Page.
[out]pTrimBoxRetrieved value.
Returns
FALSE if either an error occurred or the [out] argument returns NULL. To determine if an error has occurred, check the error code as described in the note section below.
Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Page_GetWidgets()

the list of this page's form field widgets. Adding to this list results in an error:

  • IllegalState if the list has already been closed
  • UnsupportedOperation if the document is read-only
  • IllegalArgument
    • if the given widget is NULL
    • if the given widget object has already been closed
    • if the given widget does not belong to the same document as the list
    • if the given widget is already associated with a page This list does not support removing or setting elements or clearing.
Parameters
[in,out]pPageActs as a handle to the native object of type TPtxPdf_Page.
Returns
Retrieved value.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Page_Rotate()

Rotate the page by a multiple of 90 degrees.

Parameters
[in,out]pPageActs as a handle to the native object of type TPtxPdf_Page.
[in]iRotatethe desired rotation
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Page_SetMetadata()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_SetMetadata ( TPtxPdf_Page * pPage,
TPtxPdf_Metadata * pMetadata )

the metadata of the page.

If the document is writable, the metadata object will be writable too and all changes to the metadata object are reflected in the document.

This property is NULL if the page has not metadata.

Parameters
[in,out]pPageActs as a handle to the native object of type TPtxPdf_Page.
[in,out]pMetadataSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_Page_UpdateSize()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_Page_UpdateSize ( TPtxPdf_Page * pPage,
const TPtxGeomReal_Rectangle * pRectangle )

Update the page size to a specified rectangle. Note that all page-related coordinates are normalized to the crop box of the page. Updating the page size thus changes the coordinate system, rendering all previously extracted coordinates invalid.

Parameters
[in,out]pPageActs as a handle to the native object of type TPtxPdf_Page.
[in]pRectanglethe rectangle to update the page size to.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_PageCopyOptions_GetAnnotations()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_CopyStrategy PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetAnnotations ( TPtxPdf_PageCopyOptions * pPageCopyOptions)

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 products.

Default value: ePtxPdf_CopyStrategy_Copy

Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageCopyOptions_GetCopyAssociatedFiles()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetCopyAssociatedFiles ( TPtxPdf_PageCopyOptions * pPageCopyOptions)

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

Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageCopyOptions_GetCopyLogicalStructure()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetCopyLogicalStructure ( TPtxPdf_PageCopyOptions * pPageCopyOptions)

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

Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageCopyOptions_GetCopyOutlineItems()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetCopyOutlineItems ( TPtxPdf_PageCopyOptions * pPageCopyOptions)

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

Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageCopyOptions_GetFormFieldConflictResolution()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_NameConflictResolution PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetFormFieldConflictResolution ( TPtxPdf_PageCopyOptions * pPageCopyOptions)

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: ePtxPdf_NameConflictResolution_Merge

Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageCopyOptions_GetFormFields()

Copy strategy for form fields and widgets.

Specifies how form fields and widgets are treated when copying a page.

Default value: ePtxPdfForms_FormFieldCopyStrategy_Copy

Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageCopyOptions_GetLinks()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_CopyStrategy PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetLinks ( TPtxPdf_PageCopyOptions * pPageCopyOptions)

Copy strategy for links.

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

Default value: ePtxPdf_CopyStrategy_Copy

Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageCopyOptions_GetNamedDestinations()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdfNav_NamedDestinationCopyStrategy PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetNamedDestinations ( TPtxPdf_PageCopyOptions * pPageCopyOptions)

Copy strategy for named destinations.

Specify whether named destinations are resolved when copying a page.

Default value: ePtxPdfNav_NamedDestinationCopyStrategy_Copy

Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageCopyOptions_GetOcgConflictResolution()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_NameConflictResolution PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetOcgConflictResolution ( TPtxPdf_PageCopyOptions * pPageCopyOptions)
Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.
Deprecated
Deprecated in Version 1.0. Setting this property has no effect. When copying pages from multiple documents, layers (optional content groups, OCG) are always merged.

◆ PtxPdf_PageCopyOptions_GetOptimizeResources()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetOptimizeResources ( TPtxPdf_PageCopyOptions * pPageCopyOptions)

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 decreases performance.

Default value: TRUE

Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageCopyOptions_GetSignedSignatures()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_RemovalStrategy PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetSignedSignatures ( TPtxPdf_PageCopyOptions * pPageCopyOptions)

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: ePtxPdf_RemovalStrategy_Remove

Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageCopyOptions_GetUnsignedSignatures()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_CopyStrategy PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_GetUnsignedSignatures ( TPtxPdf_PageCopyOptions * pPageCopyOptions)

Copy strategy for unsigned signature fields.

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

Default value: ePtxPdf_CopyStrategy_Copy

Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
Returns
Retrieved value.

May indicate an error in certain scenarios. For further information see the note section below.

Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageCopyOptions_New()

Returns
Handle to the newly created native object.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageCopyOptions_SetAnnotations()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetAnnotations ( TPtxPdf_PageCopyOptions * pPageCopyOptions,
TPtxPdf_CopyStrategy iAnnotations )

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 products.

Default value: ePtxPdf_CopyStrategy_Copy

Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
[in]iAnnotationsSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageCopyOptions_SetCopyAssociatedFiles()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetCopyAssociatedFiles ( TPtxPdf_PageCopyOptions * pPageCopyOptions,
BOOL bCopyAssociatedFiles )

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

Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
[in]bCopyAssociatedFilesSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageCopyOptions_SetCopyLogicalStructure()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetCopyLogicalStructure ( TPtxPdf_PageCopyOptions * pPageCopyOptions,
BOOL bCopyLogicalStructure )

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

Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
[in]bCopyLogicalStructureSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageCopyOptions_SetCopyOutlineItems()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetCopyOutlineItems ( TPtxPdf_PageCopyOptions * pPageCopyOptions,
BOOL bCopyOutlineItems )

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

Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
[in]bCopyOutlineItemsSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageCopyOptions_SetFormFieldConflictResolution()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetFormFieldConflictResolution ( TPtxPdf_PageCopyOptions * pPageCopyOptions,
TPtxPdf_NameConflictResolution iFormFieldConflictResolution )

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: ePtxPdf_NameConflictResolution_Merge

Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
[in]iFormFieldConflictResolutionSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageCopyOptions_SetFormFields()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetFormFields ( TPtxPdf_PageCopyOptions * pPageCopyOptions,
TPtxPdfForms_FormFieldCopyStrategy iFormFields )

Copy strategy for form fields and widgets.

Specifies how form fields and widgets are treated when copying a page.

Default value: ePtxPdfForms_FormFieldCopyStrategy_Copy

Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
[in]iFormFieldsSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageCopyOptions_SetLinks()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetLinks ( TPtxPdf_PageCopyOptions * pPageCopyOptions,
TPtxPdf_CopyStrategy iLinks )

Copy strategy for links.

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

Default value: ePtxPdf_CopyStrategy_Copy

Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
[in]iLinksSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageCopyOptions_SetNamedDestinations()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetNamedDestinations ( TPtxPdf_PageCopyOptions * pPageCopyOptions,
TPtxPdfNav_NamedDestinationCopyStrategy iNamedDestinations )

Copy strategy for named destinations.

Specify whether named destinations are resolved when copying a page.

Default value: ePtxPdfNav_NamedDestinationCopyStrategy_Copy

Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
[in]iNamedDestinationsSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageCopyOptions_SetOcgConflictResolution()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetOcgConflictResolution ( TPtxPdf_PageCopyOptions * pPageCopyOptions,
TPtxPdf_NameConflictResolution iOcgConflictResolution )
Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
[in]iOcgConflictResolutionSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.
Deprecated
Deprecated in Version 1.0. Setting this property has no effect. When copying pages from multiple documents, layers (optional content groups, OCG) are always merged.

◆ PtxPdf_PageCopyOptions_SetOptimizeResources()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetOptimizeResources ( TPtxPdf_PageCopyOptions * pPageCopyOptions,
BOOL bOptimizeResources )

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 decreases performance.

Default value: TRUE

Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
[in]bOptimizeResourcesSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageCopyOptions_SetSignedSignatures()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetSignedSignatures ( TPtxPdf_PageCopyOptions * pPageCopyOptions,
TPtxPdf_RemovalStrategy iSignedSignatures )

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: ePtxPdf_RemovalStrategy_Remove

Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
[in]iSignedSignaturesSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageCopyOptions_SetUnsignedSignatures()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageCopyOptions_SetUnsignedSignatures ( TPtxPdf_PageCopyOptions * pPageCopyOptions,
TPtxPdf_CopyStrategy iUnsignedSignatures )

Copy strategy for unsigned signature fields.

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

Default value: ePtxPdf_CopyStrategy_Copy

Parameters
[in,out]pPageCopyOptionsActs as a handle to the native object of type TPtxPdf_PageCopyOptions.
[in]iUnsignedSignaturesSet value.
Returns
TRUE if the operation is successful; FALSE if there is an error.
Note
An error occurred when FALSE was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage.

◆ PtxPdf_PageList_Add()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageList_Add ( TPtxPdf_PageList * pPageList,
TPtxPdf_Page * pPage )

Add an element to the end of the list.

Parameters
[in,out]pPageListActs as a handle to the native object of type TPtxPdf_PageList.
[in,out]pPage
Returns
May indicate an error in certain scenarios. For further information see the note section below.
Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_PageList_AddRange()

PDFTOOLS_TOOLBOX_EXPORT BOOL PDFTOOLS_TOOLBOX_CALL PtxPdf_PageList_AddRange ( TPtxPdf_PageList * pPageList,
TPtxPdf_PageList * pInput )

Add range of elements to th end of the list.

Parameters
[in,out]pPageListActs as a handle to the native object of type TPtxPdf_PageList.
[in,out]pInput
Returns
May indicate an error in certain scenarios. For further information see the note section below.
Note
An error occurred when FALSE was returned and the error code returned by Ptx_GetLastError is different from ePtx_Error_Success. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_PageList_Copy()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_PageList *PDFTOOLS_TOOLBOX_CALL PtxPdf_PageList_Copy ( TPtxPdf_Document * pTargetDocument,
TPtxPdf_PageList * pPageList,
TPtxPdf_PageCopyOptions * pOptions )

Copy a page list Copy pages from an input document to the given pTargetDocument. The returned list is associated with the given target document but not yet part of it. It can be appended to the document's page list.

Parameters
[in,out]pTargetDocumentthe output document with which the returned object is associated
[in,out]pPageLista page list of a different document
[in,out]pOptionsthe copy options
Returns
the copied page list, associated with the target document.

NULL if there is an error.

Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_PageList_Get()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_Page *PDFTOOLS_TOOLBOX_CALL PtxPdf_PageList_Get ( TPtxPdf_PageList * pPageList,
int iIndex )

Returns the element at the specified position in the given list.

Parameters
[in,out]pPageListActs as a handle to the native object of type TPtxPdf_PageList.
[in]iIndex
Returns
NULL if there is an error.
Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_PageList_GetCount()

PDFTOOLS_TOOLBOX_EXPORT int PDFTOOLS_TOOLBOX_CALL PtxPdf_PageList_GetCount ( TPtxPdf_PageList * pPageList)

Get the number of elements in the list.

Parameters
[in,out]pPageListActs as a handle to the native object of type TPtxPdf_PageList.
Returns
May indicate an error in certain scenarios. For further information see the note section below.
Note
An error occurred when 0 was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes:

◆ PtxPdf_PageList_GetRange()

PDFTOOLS_TOOLBOX_EXPORT TPtxPdf_PageList *PDFTOOLS_TOOLBOX_CALL PtxPdf_PageList_GetRange ( TPtxPdf_PageList * pPageList,
int iIndex,
int iCount )

Get range of elements.

Parameters
[in,out]pPageListActs as a handle to the native object of type TPtxPdf_PageList.
[in]iIndex
[in]iCount
Returns
NULL if there is an error.
Note
An error occurred when NULL was returned. Retrieve specific error code by calling Ptx_GetLastError. Get the error message with Ptx_GetLastErrorMessage. Possible error codes: