SetOutlineRemoteDestinationA

Yer İmleri (Outlines)

Açıklama

Sondaki A, ANSI (char) DLL giriş noktasını belirtir; ActiveX/COM yüzeyi yalnızca Unicode biçimini sunar. Davranış SetOutlineRemoteDestination ile aynıdır ve dize bağımsız değişkenleri geçerli SetAnsiMode kod sayfası kullanılarak yorumlanır

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 DLSetOutlineRemoteDestinationA(InstanceID, OutlineID: Integer; FileName: PAnsiChar; OpenPage, Zoom, DestType: Integer; PntLeft, PntTop, PntRight, PntBottom: Double; NewWindow: Integer): Integer;

DLL

int DLSetOutlineRemoteDestinationA(int InstanceID, int OutlineID, const char * 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

0OutlineID geçersizdi
1Yer imi hedefi başarıyla ayarlandı double PntBottom, int NewWindow);