NewDestination
Anmerkungen und Hotspot-Links, Dokumentverwaltung
Beschreibung
Prüfen Sie Syntax, Parameter und Rückgabewerte, bevor Sie die Funktion aufrufen Die Codeblöcke bleiben im Original erhalten, damit Beispiele unverändert übernommen werden können.
Syntax
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 LongDLL
int DLNewDestination(int InstanceID, int DestPage, int Zoom, int DestType, double Left, double Top, double Right, double Bottom);Parameter
| DestPage | Die Seitennummer, auf die dieses Zielobjekt verweist |
|---|---|
| Zoom | Der für das Zielobjekt zu verwendende Zoomprozentsatz; gültige Werte reichen von 0 bis 6400. Wird nur für DestType = 1 verwendet und sollte für andere DestTypes auf 0 gesetzt werden. |
| DestType | 1 = "XYZ" - Die Zielseite wird an dem durch die Parameter Left und Top angegebenen Punkt positioniert. Der Parameter Zoom gibt den Zoomprozentsatz an. 2 = "Fit" - Die gesamte Seite wird so skaliert, dass sie in das Fenster passt. Keiner der anderen Parameter wird verwendet; sie sollten auf null gesetzt werden. 3 = "FitH" - Die Seite wird so skaliert, dass ihre gesamte Breite sichtbar ist. Die Seitenhöhe kann größer oder kleiner als die Fensterhöhe sein. Die Seite wird an der durch den Parameter Top angegebenen vertikalen Position ausgerichtet. 4 = "FitV" - Die Seite wird so skaliert, dass ihre gesamte Höhe sichtbar ist. Die Seitenbreite kann größer oder kleiner als die Fensterbreite sein. Die Seite wird an der durch den Parameter Left angegebenen horizontalen Position ausgerichtet. 5 = "FitR" - Die Seite wird so skaliert, dass ein bestimmtes Rechteck auf der Seite sichtbar ist. Die Parameter Left, Top, Right und Bottom definieren den rechteckigen Bereich auf der Seite. 6 = "FitB" - Die Seite wird so skaliert, dass ihr 'Begrenzungsrahmen' sichtbar ist. 7 = "FitBH" - Die Seite wird vertikal an der durch den Parameter Top angegebenen Position ausgerichtet. Die Seite wird so skaliert, dass die 'gesamte Breite' des Seitenbegrenzungsrahmens sichtbar ist. 8 = "FitBV" - Die Seite wird an der durch den Parameter Left angegebenen horizontalen Position ausgerichtet. Die Seite wird gerade so weit skaliert, dass die gesamte Höhe des Begrenzungsrahmens in das Fenster passt. |
| Left | Die von DestType = 1, 4, 5 und 8 verwendete horizontale Position |
| Top | Die von DestType = 1, 3, 5 und 7 verwendete vertikale Position Die horizontale Position der rechten Kante des Rechtecks. Wird von DestType = 5 verwendet |
| Right | |
| Bottom | Die horizontale Position der unteren Rechteckkante. Wird von DestType = 5 verwendet |
Rückgabewerte
| 0 | Der Parameter DestPage war ungültig Ein DestID-Wert |
|---|---|
| Non-zero |