DynaPDF Manual - Page 185
Previous Page 184 Index Next Page 186
Function Reference
Page 185 of 874
AssociateEmbFile
Syntax :
LBOOL pdfAssociateEmbFile(
const PPDF* IPDF,
// Instance pointer
TAFDestObject DestObject,
// Destination object type (see below)
SI32 DestHandle,
// Destination object handle or -1
TAFRelationship Relationship, // see below
UI32 EmbFile)
// Handle of an embedded file
typedef enum
{
arAssociated,
arData,
arSource,
arSupplement,
arAlternative, // This key must be used for ZUGFeRD compatible invoices
arFormData
}TAFRelationship;
typedef enum
{
adAnnotation,
adCatalog,
// The documents catalog is the root object
adField,
adImage,
adPage,
adTemplate
}TAFDestObject;
The function associates an embedded file with a PDF object. The parameter DestHandle must be a
valid handle of a PDF object. If destination object type is a page, then the page number must be used
as handle. The first page is denoted by one. If the destination object is the documents catalog then
the parameter DestHandle is ignored. Set the parameter to zero or -1 in this case.
The parameter EmbFile must be a valid handle of an embedded file. See AttachFile() or
AttachFileEx() for further information.
For FacturX, ZUGFeRD, and XRechnung embedded files must be associated to the Catalog object.
Relationship must be set as follows:
Profile
Relationship
ctZUGFeRD_Basic
arAlternative
ctZUGFeRD_Comfort
arAlternative
ctZUGFeRD_Extended
arAlternative
ctZUGFeRD2_Minimum
arData or arSource
ctZUGFeRD2_Basic
arAlternative
ctZUGFeRD2_Basic_WL
arData or arSource
ctZUGFeRD2_Comfort
arAlternative
ctZUGFeRD2_Extended
arAlternative
ctFacturX_Minimum
arData or arSource
ctFacturX_Basic
arAlternative
ctFacturX_Basic_WL
arData or arSource
ctFacturX_Comfort
arAlternative
ctFacturX_Extended
arAlternative
ctFacturX_XRechnung
arSource
Previous topic: ApplyShading
Next topic: AttachFile, AttachFileEx