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
| 0 | OutlineID geçersizdi |
|---|---|
| 1 | Yer imi hedefi başarıyla ayarlandı double PntBottom, int NewWindow); |