AddLinkToEmbeddedFile

Vlastnosti dokumentu, anotácie a aktívne odkazy

Opis

Pridáva na vybranú stránku obdĺžnik anotácie FileAttachment a prepojí ho s vloženým súborom, ktorý je už uložený v dokumente.

Najprv zavolajte AddEmbeddedFile, aby sa bajty súboru skopírovali do PDF a získal sa EmbeddedFileID. AddLinkToEmbeddedFile vytvorí anotáciu stránky, zapíše názov prílohy a obsah kontextového okna a nasmeruje anotáciu na túto špecifikáciu vloženého súboru.

Správanie verzie PDF: anotácie FileAttachment a prúdy vložených súborov vyžadujú PDF 1.3. Vzhľad anotácie vytvorený touto funkciou môže obsahovať nepriehľadnosť anotácie cez /CA a transparentné zdroje, ktoré vyžadujú PDF 1.4. Ak je aktuálna verzia dokumentu nižšia a verzia pri ukladaní nie je uzamknutá, AddLinkToEmbeddedFile automaticky zvýši dokument na PDF 1.4 a zaznamená /CA annotation opacity do AutoBumpedFeatures. Ak volajúci uzamkne nižšiu verziu pri ukladaní, kontrola kompatibility odmietne uloženie s LastErrorCode 602.

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

Parametre

Left	Horizontálna súradnica ľavého okraja obdĺžnika anotácie.
Top	Zvislá súradnica horného okraja obdĺžnika anotácie.
Width	Šírka obdĺžnika anotácie.
Height	Výška obdĺžnika anotácie.
EmbeddedFileID	Hodnota vrátená funkciou AddEmbeddedFile.
Title	Názov prílohy zobrazený v prehliadači PDF.
Contents	Text zobrazený v kontextovom okne anotácie.
IconType	Ikona anotácie: 0 = PushPin, 1 = ikona disku, 2 = bez ikony, 3 = graf, 4 = kancelárska sponka, 5 = štítok, 6 = plný biely obdĺžnik.
Transparency	Percento priehľadnosti od 0 do 100. Nula je úplne nepriehľadná; 100 spraví ikonu neviditeľnou.

Návratové hodnoty

0	Hodnota EmbeddedFileID je neplatná, nie je vybraná žiadna strana alebo nie je aktívny žiadny dokument.
1	Anotácia FileAttachment bola úspešne vytvorená.

Pozri aj

AddEmbeddedFile, AddFileAttachment, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount