AddLinkToEmbeddedPDFA
Аннотации и активные ссылки
Описание
Завершающая A обозначает точку входа DLL типа ANSI (char); интерфейс ActiveX/COM предоставляет только форму Unicode. Поведение идентично AddLinkToEmbeddedPDF, а строковые аргументы интерпретируются с использованием текущей кодовой страницы SetAnsiMode
Добавляет на выбранную страницу ссылку, открывающую PDF-документ, встроенный в текущий файл, и переходящую на страницу в нём. Ссылка несёт встроенное действие go-to (/GoToE) согласно ISO 32000-1 §12.6.4.4: цепочка целей называет встроенный файл (имя, переданное в EmbedFile) в дереве имён EmbeddedFiles документа, а переход вписывает целевую страницу в окно
Поскольку /GoToE появился в PDF 1.6, функция при необходимости поднимает версию документа до 1.6. Прочитать такие действия обратно можно функцией GetAnnotActionInfo: она сообщает тип akGoToE вместе с именем встроенной цели, связью родитель/потом и флагом /NewWindow
Синтаксис
Delphi
Function DLAddLinkToEmbeddedPDFA(InstanceID: Integer; Left, Top, Width, Height: Double; EmbeddedFileName: PAnsiChar; TargetPage, NewWindow, Options: Integer): Integer;DLL
int DLAddLinkToEmbeddedPDFA(int InstanceID, double Left, double Top, double Width, double Height, const char * EmbeddedFileName, int TargetPage, int NewWindow, int Options);Параметры
| Left, Top, Width, Height | Позиция и размер активной области на выбранной странице |
|---|---|
| EmbeddedFileName | Имя встроенного файла в дереве имён EmbeddedFiles документа — то, что передавалось в EmbedFile (например "report.pdf") |
| TargetPage | Целевая страница встроенного документа, начиная с 1 |
| NewWindow | 1 = попросить просмотрщик открыть встроенный документ в новом окне, 0 = настройка просмотрщика по умолчанию |
| Options | 1 = нарисовать рамку вокруг активной области, 0 = без рамки |
Возвращаемые значения
| 0 | Ссылку добавить не удалось (пустое имя или недопустимая страница) |
|---|---|
| 1 | Success |