AddLinkToEmbeddedFileA
Document properties, Annotations and hotspot links
Опис
Завершальна A позначає точку входу DLL для ANSI (char); поверхня ActiveX/COM експонує лише форму Unicode. Поведінка ідентична AddLinkToEmbeddedFile, а рядкові аргументи трактуються за поточною кодовою сторінкою SetAnsiMode
Додає до вибраної сторінки прямокутник анотації FileAttachment і пов'язує його з вбудованим файлом, який уже є в документі
Спершу викличте AddEmbeddedFile, щоб скопіювати байти файла в PDF і отримати EmbeddedFileID. AddLinkToEmbeddedFile створює анотацію на сторінці, записує назву вкладення та вміст спливного вікна й спрямовує анотацію на ту специфікацію вбудованого файла
Поведінка версії PDF: анотації FileAttachment і потоки вбудованих файлів вимагають PDF 1.3. Згенерований вигляд анотації може включати непрозорість через /CA і ресурси прозорості, що вимагає PDF 1.4. Якщо поточна версія документа нижча, а версія збереження не зафіксована, AddLinkToEmbeddedFile автоматично підвищує документ до PDF 1.4 і записує /CA annotation opacity в AutoBumpedFeatures. Якщо викликач зафіксував нижчу версію збереження, шлюз сумісності відхилить збереження з LastErrorCode 602
Синтаксис
Delphi
Function DLAddLinkToEmbeddedFileA(InstanceID: Integer; Left, Top, Width, Height: Double; EmbeddedFileID: Integer; Title, Contents: PAnsiChar; IconType, Transpareny: Integer): Integer;DLL
int DLAddLinkToEmbeddedFileA(int InstanceID, double Left, double Top, double Width, double Height, int EmbeddedFileID, const char * Title, const char * Contents, int IconType, int Transpareny);Параметри
| Left | Горизонтальна координата лівого краю прямокутника анотації |
|---|---|
| Top | Вертикальна координата верхнього краю прямокутника анотації |
| Width | Ширина прямокутника анотації |
| Height | Висота прямокутника анотації |
| EmbeddedFileID | Значення, яке повертає AddEmbeddedFile |
| Title | Назва вкладення, яку показує PDF-переглядач |
| Contents | Текст, показуваний у спливному вікні анотації |
| IconType | Піктограма анотації: 0 = PushPin, 1 = зображення диска, 2 = без піктограми, 3 = графік, 4 = паперова скріпка, 5 = тег, 6 = суцільний білий прямокутник |
| Transparency | Відсоток прозорості від 0 до 100. Нуль — повністю непрозоро; 100 робить піктограму невидимою |
Return values
| 0 | EmbeddedFileID недійсний, сторінку не вибрано або активного документа немає |
|---|---|
| 1 | Анотацію FileAttachment успішно створено |
Див. також
AddEmbeddedFile, AddFileAttachment, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount