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