AddLinkToEmbeddedFile

Documenteigenschappen, annotaties en hotspotkoppelingen

Beschrijving

Voegt een rechthoek voor een FileAttachment-annotatie toe aan de geselecteerde pagina en koppelt deze aan een ingesloten bestand dat al in het document is opgeslagen

Roep eerst AddEmbeddedFile aan om de bestandsbytes in de PDF te kopiëren en de EmbeddedFileID te verkrijgen. AddLinkToEmbeddedFile maakt de pagina-annotatie, schrijft de bijlagetitel en popup-inhoud en laat de annotatie naar die filespecificatie van het ingesloten bestand wijzen

PDF-versiegedrag: FileAttachment-annotaties en ingesloten-bestandsstreams vereisen PDF 1.3. De door deze functie gegenereerde annotatieappearance kan annotatiedekking via /CA en transparantieresources bevatten, die PDF 1.4 vereisen. Is de huidige documentversie lager en is de opslagversie niet vergrendeld, dan verhoogt AddLinkToEmbeddedFile het document automatisch naar PDF 1.4 en registreert /CA annotation opacity in AutoBumpedFeatures. Vergrendelt de aanroeper een lagere opslagversie, dan weigert de compatibiliteitspoort het opslaan met LastErrorCode 602

Syntaxis

Delphi

Function TPDFlib.AddLinkToEmbeddedFile(Left, Top, Width, Height: Double; EmbeddedFileID: Integer; Const Title, Contents: WideString; IconType, Transparency: Integer): Integer;

ActiveX

Function PDFlib::AddLinkToEmbeddedFile(Left As Double, Top As Double, Width As Double, Height As Double, EmbeddedFileID As Long, Title As String, Contents As String, IconType As Long, transpareny As Long) As Long

DLL

int DLAddLinkToEmbeddedFile(int InstanceID, double Left, double Top, double Width, double Height, int EmbeddedFileID, const wchar_t * Title, const wchar_t * Contents, int IconType, int transpareny);

Parameters

Left	De horizontale coördinaat van de linkerrand van de annotatierrechthoek
Top	De verticale coördinaat van de bovenrand van de annotatierrechthoek
Width	De breedte van de annotatierechthoek
Height	De hoogte van de annotatierrechthoek
EmbeddedFileID	De waarde geretourneerd door AddEmbeddedFile
Title	De bijlagetitel die de PDF-viewer toont
Contents	De tekst die in de annotatiepopup wordt getoond
IconType	Het annotatie-icoon: 0 = PushPin, 1 = disk image, 2 = geen icoon, 3 = graph, 4 = paperclip, 5 = tag, 6 = effen witte rechthoek
Transparency	Het transparantiepercentage van 0 tot 100. Nul is volledig dekkend; 100 maakt het icoon onzichtbaar

Retourwaarden

0	De EmbeddedFileID is ongeldig, er is geen pagina geselecteerd of er is geen document actief
1	De FileAttachment-annotatie is aangemaakt

Zie ook

AddEmbeddedFile, AddFileAttachment, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount