NewDestination

Adnotacje i łącza obszarów aktywnych, Zarządzanie dokumentem

Opis

Tworzy nowy obiekt celu, którego można użyć z funkcjami AddLinkToDestination, GetDestPage, GetDestType lub GetDestValue

Składnia

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

DestPageNumer strony wskazywanej przez ten obiekt celu
ZoomProcent powiększenia dla obiektu celu; prawidłowe wartości wynoszą od 0 do 6400. Używany tylko dla DestType = 1; dla innych wartości DestType należy ustawić 0
DestType1 = "XYZ" — strona docelowa jest ustawiana w punkcie określonym parametrami Left i Top. Parametr Zoom określa procent powiększenia. 2 = "Fit" — cała strona jest skalowana tak, aby zmieściła się w oknie. Pozostałe parametry nie są używane i należy ustawić je na zero. 3 = "FitH" — strona jest skalowana tak, aby widoczna była jej pełna szerokość. Wysokość strony może być większa lub mniejsza od wysokości okna. Strona jest ustawiana w położeniu pionowym określonym parametrem Top. 4 = "FitV" — strona jest skalowana tak, aby widoczna była jej pełna wysokość. Szerokość strony może być większa lub mniejsza od szerokości okna. Strona jest ustawiana w położeniu poziomym określonym parametrem Left. 5 = "FitR" — strona jest skalowana tak, aby widoczny był określony prostokąt. Parametry Left, Top, Right i Bottom definiują prostokątny obszar strony. 6 = "FitB" — strona jest skalowana tak, aby widoczny był jej prostokąt ograniczający (ang. page's bounding box). 7 = "FitBH" — strona jest ustawiana pionowo w położeniu określonym parametrem Top. Strona jest skalowana tak, aby widoczna była pełna szerokość prostokąta ograniczającego stronę (ang. page's bounding box). 8 = "FitBV" — strona jest ustawiana w położeniu poziomym określonym parametrem Left. Strona jest skalowana tylko na tyle, aby pełna wysokość prostokąta ograniczającego zmieściła się w oknie
LeftPołożenie poziome używane przez DestType = 1, 4, 5 i 8
TopPołożenie pionowe używane przez DestType = 1, 3, 5 i 7 Położenie poziome prawej krawędzi prostokąta. Używane przez DestType = 5
Right
BottomPołożenie poziome dolnej krawędzi prostokąta. Używane przez DestType = 5

Wartości zwracane

0Parametr DestPage był nieprawidłowy Wartość DestID
Non-zero