AddLinkToNamedDestinationA

Аннотации и активные ссылки, свойства страницы

Описание

Завершающая A обозначает точку входа ANSI (char) в DLL; интерфейс ActiveX/COM открывает только Unicode-форму. Поведение идентично AddLinkToNamedDestination, а строковые аргументы интерпретируются в кодовой странице, заданной текущим режимом SetAnsiMode

Добавляет на выбранную страницу кликабельный прямоугольник активной области, переходящий к именованной цели в том же PDF-документе. Сначала зарегистрируйте цель функциями NewDestination и NewNamedDestination, затем создавайте активные области, ссылающиеся на стабильное имя цели, вместо дублирования номера страницы и массива перехода

Цвет границы активной области изменяется функцией SetAnnotBorderColor

Синтаксис

Delphi

Function DLAddLinkToNamedDestinationA(InstanceID: Integer; Left, Top, Width, Height: Double; DestName: PAnsiChar; Options: Integer): Integer;

DLL

int DLAddLinkToNamedDestinationA(int InstanceID, double Left, double Top, double Width, double Height, const char * DestName, int Options);

Параметры

LeftГоризонтальная координата левого края интерактивного прямоугольника
TopВертикальная координата верхнего края интерактивного прямоугольника
WidthШирина интерактивного прямоугольника
HeightВысота интерактивного прямоугольника
DestNameИменованная цель перехода; имя должно уже существовать в дереве имён документа — обычно создаётся через NewNamedDestination
OptionsБитовая маска вида ссылки. Бит 0 (значение 1): рисовать рамку вокруг прямоугольника активной области. Биты 1–3 выбирают режим подсветки щелчка (2 = Invert, 4 = Outline, 8 = Push); если ни один бит подсветки не установлен, по умолчанию используется Invert

Возвращаемые значения

0DestName пуст либо ссылку создать не удалось
1Ссылка на именованную цель добавлена на выбранную страницу

Примечания

Аннотация-ссылка записывает действие GoTo, чьей целью служит строка именованной цели; активные области остаются стабильными при вставке или перемещении страниц после создания именованной цели