AddLinkToNamedDestinationA

Anotace a hotspotové odkazy, vlastnosti stránek

Popis

Koncové A označuje vstupní bod DLL pro ANSI (char); povrch ActiveX/COM vystavuje jen Unicode formu. Chování je shodné s AddLinkToNamedDestination a řetězcové argumenty se interpretují podle aktuální kódové stránky SetAnsiMode

Přidá na vybranou stránku klikací obdélník aktivní oblasti, který skočí na pojmenovaný cíl ve stejném PDF dokumentu. Cíl nejprve zaregistrujte funkcemi NewDestination a NewNamedDestination a teprve potom vytvořte aktivní oblasti odkazující na stabilní název cíle, abyste nemuseli duplikovat číslo stránky a cílové pole

Barvu rámečku aktivní oblasti změníte funkcí SetAnnotBorderColor

Syntaxe

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);

Parametry

Left	Vodorovná souřadnice levého okraje obdélníku aktivní oblasti
Top	Svislá souřadnice horního okraje obdélníku aktivní oblasti
Width	Šířka obdélníku aktivní oblasti
Height	Výška obdélníku aktivní oblasti
DestName	Pojmenovaný cíl, na který se má skočit. Název už by měl existovat ve stromu názvů dokumentu, obvykle přes NewNamedDestination
Options	Bitová maska řídící vzhled odkazu. Bit 0 (hodnota 1): nakreslí rámeček kolem obdélníku aktivní oblasti. Bity 1–3 volí režim zvýraznění při kliknutí (2 = Invert, 4 = Outline, 8 = Push); není-li nastaven žádný bit zvýraznění, použije se výchozí Invert

Návratové hodnoty

0	DestName bylo prázdné, nebo se odkaz nepodařilo vytvořit
1	Odkaz na pojmenovaný cíl se přidal na vybranou stránku

Poznámky

Anotace odkazu zapíše akci GoTo, jejímž cílem je řetězec pojmenovaného cíle. Aktivní oblasti tak zůstávají stabilní, i když se stránky po vytvoření pojmenovaného cíle vloží nebo přesunou