SetOutlineRemoteDestination

Yer İmleri (Outlines)

Açıklama

Anahat öğesini (yer imi) tıklandığında başka bir PDF açacak şekilde ayarlar

Açılış sayfası numarası ile çeşitli boyutlandırma/konumlandırma değerleri belirtilebilir

Not: hedef belgenin sayfa boyutu bilinmediği için tüm konumlar açılış sayfasının sol alt köşesinden ölçülen noktalarla belirtilir

Sözdizimi

Delphi

Function TPDFlib.SetOutlineRemoteDestination(OutlineID: Integer; Const FileName: WideString; OpenPage, Zoom, DestType: Integer; PntLeft, PntTop, PntRight, PntBottom: Double; NewWindow: Integer): Integer;

ActiveX

Function PDFlib::SetOutlineRemoteDestination(OutlineID As Long, FileName As String, OpenPage As Long, Zoom As Long, DestType As Long, PntLeft As Double, PntTop As Double, PntRight As Double, PntBottom As Double, NewWindow As Long) As Long

DLL

int DLSetOutlineRemoteDestination(int InstanceID, int OutlineID, const wchar_t * FileName, int OpenPage, int Zoom, int DestType, double PntLeft, double PntTop, double PntRight, double PntBottom, int NewWindow);

Parametreler

OutlineID

NewOutline işlevinin döndürdüğü ana hat kimliği. Alternatif olarak geçerli bir ana hat kimliği almak için GetOutlineID işlevini kullanın

FileName

Ana hat tıklandığında açılacak PDF belgesinin dosya adı. Belirli bir biçimde olmalıdır. Ters eğik çizgiler eğik çizgilere dönüştürülmeli ve varsa sürücü, iki eğik çizgi arasında iki nokta olmadan yalnızca sürücü harfiyle belirtilmelidir. Örneğin "c:\my documents\hello.pdf" dosyası "/c/my documents/hello.pdf" olarak belirtilmelidir. Bir dizin yukarı çıkmak için ".." işlecini içeren yollar dahil göreli yol adları geçerlidir

OpenPage

Hedef belge açıldığında gidilecek sayfa numarası. İlk sayfanın dizini sıfırdır (0)

Zoom

Belge açıldığında kullanılacak yakınlaştırma yüzdesi; geçerli değerler 0 ile 6400 arasındadır. Yalnızca DestType = 1 için kullanılır, diğer DestType değerlerinde 0 olarak ayarlanmalıdır

DestType

1 = "XYZ" - hedef sayfa Left ve Top parametreleriyle belirtilen noktaya konumlandırılır. Zoom parametresi yakınlaştırma yüzdesini belirtir

2 = "Fit" - sayfanın tamamı pencereye sığacak şekilde yakınlaştırılır. Diğer parametrelerin hiçbiri kullanılmaz ve sıfır olarak ayarlanmalıdır

3 = "FitH" - sayfa, tüm genişliği görünecek biçimde yakınlaştırılır. Sayfa yüksekliği pencere yüksekliğinden büyük veya küçük olabilir. Sayfa Top parametresinin belirttiği dikey konuma yerleştirilir

4 = "FitV" - sayfa, yüksekliğinin tamamı görülebilecek şekilde yakınlaştırılır. Sayfanın genişliği pencerenin genişliğinden büyük veya küçük olabilir. Sayfa, Left parametresinin belirttiği yatay konuma yerleştirilir

5 = "FitR" - sayfa, üzerindeki belirli bir dikdörtgen görünecek şekilde yakınlaştırılır. Left, Top, Right ve Bottom parametreleri sayfadaki dikdörtgen alanı tanımlar

6 = "FitB" - sayfa, sınırlayıcı kutusu görünür olacak şekilde yakınlaştırılır'

7 = "FitBH" - sayfa, Top parametresiyle belirtilen konuma dikey olarak yerleştirilir. Sayfa, sayfanın' sınırlayıcı kutusunun tüm genişliği görünür olacak şekilde yakınlaştırılır

8 = "FitBV" - sayfa Left parametresiyle belirtilen yatay konuma yerleştirilir. Sayfa, sınırlayıcı kutunun tüm yüksekliği pencereye sığacak kadar yakınlaştırılır

PntLeft

DestType = 1, 4, 5 ve 8 tarafından kullanılan yatay konum. Konum, hedef belge'nin sayfasının sol alt köşesinden ölçülen noktalarla belirtilir

PntTop

DestType = 1, 3, 5 ve 7 tarafından kullanılan dikey konum. Konum, hedef belge'nin sayfasının sol alt köşesinden ölçülen noktalarla belirtilir

PntRight

Dikdörtgenin sağ kenarının yatay konumu. DestType = 5 tarafından kullanılır. Konum, hedef belgenin' sayfasının sol alt köşesinden ölçülen noktalarla belirtilir

PntBottom

Dikdörtgenin altının yatay konumu. DestType = 5 tarafından kullanılır. Konum, hedef belge'nin sayfasının sol alt köşesinden nokta cinsinden ölçülür

NewWindow

0 = Geçerli belgeyi hedef belgeyle değiştirir

1 = Kullanıcı PDF görüntüleyicisinde farklı bir tercih belirtmedikçe hedef belgeyi yeni bir pencerede açar

Dönüş değerleri