AddRelativeLinkToFileExA

Annotations and hotspot links

Deskripsi

Akhiran A menandai entry point DLL ANSI (char); permukaan ActiveX/COM hanya mengekspos bentuk Unicode-nya. Perilakunya identik dengan AddRelativeLinkToFileEx dan argumen string ditafsirkan memakai code page SetAnsiMode saat ini

Menambahkan rectangle hotspot yang bisa diklik ke halaman terpilih, yang memakai relative path menuju halaman dan posisi tertentu di dokumen PDF lain. Gunakan fungsi SetAnnotBorderColor untuk mengubah warna border hotspot

Link ke dokumen target hanya melalui nama file. Artinya dimensi halaman dokumen target tidak diketahui, sehingga parameter DestLeft, DestTop, DestRight, dan DestBottom selalu dinyatakan dalam point yang diukur dari pojok kiri bawah MediaBox halaman tujuan

Sintaks

Delphi

Function DLAddRelativeLinkToFileExA(InstanceID: Integer; Left, Top, Width, Height: Double; FileName: PAnsiChar; DestPage, NewWindow, Options, Zoom, DestType: Integer; DestLeft, DestTop, DestRight, DestBottom: Double): Integer;

DLL

int DLAddRelativeLinkToFileExA(int InstanceID, double Left, double Top, double Width, double Height, const char * FileName, int DestPage, int NewWindow, int Options, int Zoom, int DestType, double DestLeft, double DestTop, double DestRight, double DestBottom);

Parameter

Left

Koordinat horizontal tepi kiri rectangle hotspot

Top

Koordinat vertikal tepi atas rectangle hotspot

Width

Lebar rectangle hotspot

Height

Tinggi rectangle hotspot

FileName

Path absolut lengkap beserta nama file dokumen PDF yang menjadi target link, nantinya dikonversi menjadi relative path

DestPage

Halaman pada dokumen tujuan yang menjadi target link

NewWindow

0 = Tutup dokumen saat ini lalu buka dokumen baru

1 = Buka dokumen saat ini di window baru

Options

Menentukan tampilan link:

0 = No border

1 = Draw a border

Persentase zoom untuk objek destination, nilai valid 0 sampai 6400. Hanya dipakai untuk DestType = 1; DestType lain harus diset ke 0

Zoom

DestType

1 = "XYZ" - halaman target diposisikan pada titik yang ditentukan parameter Left dan Top. Parameter Zoom menentukan persentase zoom

2 = "Fit" - seluruh halaman di-zoom agar muat di window. Parameter lain tidak dipakai dan harus diset ke nol

3 = "FitH" - halaman di-zoom sehingga seluruh lebar halaman terlihat. Tinggi halaman bisa lebih besar atau lebih kecil dari tinggi window. Halaman diposisikan pada posisi vertikal yang ditentukan parameter Top

4 = "FitV" - halaman di-zoom sehingga seluruh tinggi halaman terlihat. Lebar halaman bisa lebih besar atau lebih kecil dari lebar window. Halaman diposisikan pada posisi horizontal yang ditentukan parameter Left

5 = "FitR" - halaman di-zoom sehingga rectangle tertentu pada halaman terlihat. Parameter Left, Top, Right, dan Bottom mendefinisikan area persegi pada halaman tersebut

6 = "FitB" - halaman di-zoom sehingga bounding box-nya terlihat

7 = "FitBH" - halaman diposisikan secara vertikal pada posisi yang ditentukan parameter Top. Halaman di-zoom sehingga seluruh lebar bounding box halaman terlihat

8 = "FitBV" - halaman diposisikan pada posisi horizontal yang ditentukan parameter Left. Halaman di-zoom pas agar seluruh tinggi bounding box muat di window

DestLeft

Posisi horizontal yang dipakai oleh DestType = 1, 4, 5, dan 8

DestTop

Posisi vertikal yang dipakai oleh DestType = 1, 3, 5, dan 7

DestRight

Posisi horizontal tepi kanan rectangle. Dipakai oleh DestType = 5

DestBottom

Posisi horizontal bagian bawah rectangle. Dipakai oleh DestType = 5

int NewWindow, int Options, int Zoom, int DestType, double DestLeft, double DestTop, double DestRight, double DestBottom);

Height: Double; FileName: WideString; DestPage, NewWindow, Options, Zoom, DestType: Integer; DestLeft, DestTop, DestRight,