TPDFlibViewer

Görüntüleyici

Açıklama

Bu sayfa PDFlibPas içinde "Görüntüleyici" konusu altındaki TPDFlibViewer denetimini belgeler. API adları, parametreler, sınıf adları, dosya adları ve değişmez değerler, Delphi kitaplığında göründükleri biçimde aynen korunur

TPDFlibViewer (Lib\PDFlibViewer.pas birimi), uygulamanızın içinde PDF sayfalarını görüntüleyen bir VCL kaydırmalı denetimdir. Ekli örnek üzerinde SelectRenderer komutuna göre TPDFlib ile aynı altyapıyı (GDI+, Cairo veya PDFium) kullanarak işler

Temel Üyeler

Function LoadFromFile(Const FileName, Password: WideString): Integer;
Procedure AttachLibrary(ALib: TPDFlib);
Procedure CloseDocument;
Function PageCount: Integer;
Function GoToPage(NewPage: Integer): Integer;
Function NextPage: Integer;
Function PrevPage: Integer;
Procedure SetZoomPercent(Percent: Double);
Procedure SetZoomMode(Mode: TPDFlibViewerZoomMode);
Procedure SetDisplayMode(Mode: TPDFlibViewerDisplayMode);
Procedure SetCacheLimit(MegaBytes: Integer);
Procedure RefreshPage;
Function LinkActionAtPagePoint(APage: Integer; XPos, YPos: Double; Out Info: TPDFlibActionInfo): Integer;
Function GetTextInRegion(APage: Integer; XPos, YPos, RWidth, RHeight: Double): WideString;
Function CopySelectedText: Integer;
Property SelectedText: WideString;
Property Page: Integer;
Property DisplayMode: TPDFlibViewerDisplayMode;
Property OnPageChange: TPDFlibViewerPageChange;
Property OnLinkClick: TPDFlibViewerLinkClick;

Notlar

LoadFromFile, denetimin kendi TPDFlib örneği aracılığıyla bir belge açar; AttachLibrary ise kendinizin yönettiği bir örneğin seçili belgesini görüntüler (sahiplik çağıranda kalır). Yakınlaştırma modları sabit bir yüzdedir (zmPercent, SetZoomPercent aracılığıyla), genişliğe sığdır (zmFitWidth, varsayılan) ve sayfaya sığdır (zmFitPage); sığdırma modları denetim yeniden boyutlandırıldığında otomatik olarak yeniden hesaplanır. Gezinme belgenin sayfa aralığına sınırlandırılır ve OnPageChange olayını yalnızca görünür sayfa gerçekten değiştiğinde tetikler. SetDisplayMode, tek sayfa görüntüleme (dmSinglePage, varsayılan) ile tüm belge boyunca sürekli dikey kaydırma (dmContinuous) arasında geçiş yapar; sürekli modda yalnızca görünüm alanında görünen sayfalar işlenir ve geçerli sayfa kaydırma konumunu takip eder. İşlenen sayfalar en az kullanılan bit eşlem önbelleğinde tutulur (varsayılan 128 MB, SetCacheLimit ile ayarlanabilir); böylece geri kaydırma sayfaları yeniden işlemez. Fare tekerleği dikey kaydırma yapar; PageUp/PageDown, ok tuşları, Home ve End gezinme sağlar. Komşu sayfalar arka plan iş parçacığında önceden işlenir, sayfa geçişleri anlık gerçekleşir. Bir bağlantı açıklamasını tıklamak, sayfa numarasını ve yazılan eylem özetini (TPDFlibActionInfo: web adresi, belge hedefi, adlandırılmış eylem ve daha fazlası) içeren OnLinkClick olayını tetikler; LinkActionAtPagePoint ise GetAnnotRectEx ile aynı kullanıcı alanındaki koordinatları alarak isabet testini doğrudan sunar. Sol fare düğmesiyle sürükleme metin seçer (bir bağlantıya tıklama bağlantıyı tetikler); Ctrl+C veya CopySelectedText seçimi kopyalar, GetTextInRegion ise aynı blok tabanlı bölge aramasını program aracılığıyla gerçekleştirir. Yardımcı denetim TPDFlibOutlineViewer, belgenin yer işareti ağacını görüntüleyicinin yanında gösterir: görüntüleyici örneğiyle AttachViewer işlevini çağırın; bir yer işaretine tıklamak hedef sayfasına gider. TPDFlibSearchPanel aynı şekilde eklenir: RunSearch belgedeki her isabet için sayfasını ve eşleşen metni listeler, bir isabete tıklamak o sayfaya atlar. TPDFlibThumbnailBar aileyi her sayfanın geç işlenen küçük resmiyle tamamlar; bir küçük resme tıklamak o sayfaya gider. Tasarım zamanında denetimi losLab PDF palet sayfasından yerleştirmek için Package\PDFlibViewerPkg.dpk tasarım zamanı paketini yükleyin