NewDestination

Anotace a hotspotové odkazy, správa dokumentů

Popis

Vytvoří nový objekt cíle, který lze použít s funkcemi AddLinkToDestination, GetDestPage, GetDestType nebo GetDestValue

Syntaxe

Delphi

Function TPDFlib.NewDestination(DestPage, Zoom, DestType: Integer; Left, Top, Right, Bottom: Double): Integer;

ActiveX

Function PDFlib::NewDestination(DestPage As Long, Zoom As Long, DestType As Long, Left As Double, Top As Double, Right As Double, Bottom As Double) As Long

DLL

int DLNewDestination(int InstanceID, int DestPage, int Zoom, int DestType, double Left, double Top, double Right, double Bottom);

Parametry

DestPageČíslo stránky, na kterou tento objekt cíle odkazuje
ZoomProcento přiblížení použité pro cílový objekt, platné hodnoty jsou od 0 do 6400. Používá se pouze pro DestType = 1, pro ostatní DestTypes musí být nastaveno 0
DestType1 = "XYZ" - cílová stránka se umístí do bodu určeného parametry Left a Top. Parametr Zoom určuje procento přiblížení. 2 = "Fit" - celá stránka se přiblíží tak, aby se vešla do okna. Ostatní parametry se nepoužívají a měly by být nastaveny na nulu. 3 = "FitH" - stránka se přiblíží tak, aby byla vidět celá její šířka. Výška stránky může být větší nebo menší než výška okna. Stránka se umístí na svislou pozici zadanou parametrem Top. 4 = "FitV" - stránka se přiblíží tak, aby byla vidět celá její výška. Šířka stránky může být větší nebo menší než šířka okna. Stránka se umístí na vodorovnou pozici zadanou parametrem Left. 5 = "FitR" - stránka se přiblíží tak, aby byl vidět určitý obdélník na stránce. Parametry Left, Top, Right a Bottom určují obdélníkovou oblast na stránce. 6 = "FitB" - stránka se přiblíží tak, aby byl vidět její ohraničující obdélník (bounding box). 7 = "FitBH" - stránka se svisle umístí na pozici zadanou parametrem Top. Přiblíží se tak, aby byla vidět celá šířka jejího ohraničujícího obdélníku. 8 = "FitBV" - stránka se vodorovně umístí na pozici zadanou parametrem Left. Přiblíží se jen tolik, aby se celá výška ohraničujícího obdélníku vešla do okna. Vodorovná pozice používaná pro DestType = 1, 4, 5 a 8
LeftVodorovná pozice používaná pro DestType = 1, 4, 5 a 8
TopSvislá pozice používaná pro DestType = 1, 3, 5 a 7 Vodorovná pozice pravé hrany obdélníku. Používá se pro DestType = 5
Right

Návratové hodnoty

0Parametr DestPage byl neplatný Hodnota DestID
Non-zero