AddLinkToEmbeddedFile
Свойства документа, аннотации и активные ссылки
Описание
Добавляет на выбранную страницу прямоугольную аннотацию 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 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);
Параметры
| Left | Горизонтальная координата левого края прямоугольника аннотации |
|---|---|
| Top | Вертикальная координата верхнего края прямоугольника аннотации |
| Width | Ширина прямоугольника аннотации |
| Height | Высота прямоугольника аннотации |
| EmbeddedFileID | Значение, возвращаемое AddEmbeddedFile |
| Title | Заголовок вложения, отображаемый PDF-просмотрщиком |
| Contents | Текст во всплывающем окне аннотации |
| IconType | Значок аннотации: 0 = PushPin, 1 = дискета, 2 = без значка, 3 = график, 4 = скрепка, 5 = ярлык, 6 = сплошной белый прямоугольник |
| Transparency | Прозрачность в процентах от 0 до 100: 0 — полностью непрозрачно, 100 — значок невидим |
Возвращаемые значения
| 0 | Недопустимый EmbeddedFileID, страница не выбрана либо активного документа нет |
|---|---|
| 1 | Аннотация FileAttachment создана успешно |
См. также
AddEmbeddedFile, AddFileAttachment, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount