AddLinkToEmbeddedFile

Dokumenteigenschaften, Anmerkungen und Hotspot-Links

Beschreibung

Prüfen Sie Syntax, Parameter und Rückgabewerte, bevor Sie die Funktion aufrufen Die Codeblöcke bleiben im Original erhalten, damit Beispiele unverändert übernommen werden können.

Rufen Sie zunächst AddEmbeddedFile auf, um die Dateibytes in die PDF-Datei zu kopieren und die EmbeddedFileID zu erhalten. AddLinkToEmbeddedFile erstellt die Seitenanmerkung, schreibt den Titel des Anhangs und den Popup-Inhalt und verweist die Anmerkung auf diese eingebettete Dateispezifikation.

Verhalten der PDF-Version: FileAttachment-Anmerkungen und eingebettete Dateistreams erfordern PDF 1.3. Das von dieser Funktion erzeugte Erscheinungsbild der Anmerkung kann über /CA und Transparenzressourcen eine Anmerkungsdeckkraft enthalten, wofür PDF 1.4 erforderlich ist. Ist die aktuelle Dokumentversion niedriger und die Speicherversion nicht gesperrt, hebt AddLinkToEmbeddedFile das Dokument automatisch auf PDF 1.4 an und trägt /CA annotation opacity in AutoBumpedFeatures ein. Sperrt der Aufrufer eine niedrigere Speicherversion, lehnt die Kompatibilitätsprüfung das Speichern mit LastErrorCode 602 ab.

Syntax

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);

Parameter

Left	Die horizontale Koordinate des linken Randes des Anmerkungsrechtecks.
Top	Die vertikale Koordinate des oberen Randes des Anmerkungsrechtecks.
Width	Die Breite des Anmerkungsrechtecks.
Height	Die Höhe des Anmerkungsrechtecks.
EmbeddedFileID	Der von AddEmbeddedFile zurückgegebene Wert.
Title	Der vom PDF-Viewer angezeigte Titel des Anhangs.
Contents	Der im Popup der Anmerkung angezeigte Text.
IconType	Das Anmerkungssymbol: 0 = PushPin, 1 = Diskettenabbild, 2 = kein Symbol, 3 = Diagramm, 4 = Büroklammer, 5 = Etikett, 6 = vollständig weißes Rechteck.
Transparency	Der Transparenzgrad von 0 bis 100 Prozent. Null bedeutet vollständig deckend; bei 100 ist das Symbol unsichtbar.

Rückgabewerte

0	Die EmbeddedFileID ist ungültig, es ist keine Seite ausgewählt oder es ist kein Dokument aktiv.
1	Die FileAttachment-Anmerkung wurde erfolgreich erstellt.

Siehe auch

AddEmbeddedFile, AddFileAttachment, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount