CapturePage
Sayfa düzenleme
Açıklama
Bu işlev bir sayfayı "yakalar". Sayfa yakalandıktan sonra başka sayfalara çizilebilir. Bu, farklı sayfaları birleştirmek veya birden çok özgün sayfayı başka bir sayfaya yerleştirmek (montaj) için kullanışlıdır. Sayfa yakalandıktan sonra belgeden kaldırılır. Sayfanın belgede kalmasını istiyorsanız boş bir sayfa oluşturup yakalanan sayfayı boş sayfaya çizmelisiniz
Ayrıca bir belge her zaman en az bir sayfa içermelidir; dolayısıyla belgedeki tek sayfaysa sayfayı yakalamak mümkün değildir. Bu durumda mevcut sayfa yakalanmadan önce yeni bir boş sayfa eklemelisiniz
CapturePage ile sayfaları bir belgeden başka yeni bir belgeye taşıyamazsınız; bu nedenle CapturePage çağrılmadan önce gerekli tüm sayfalar tek belgede birleştirilmelidir. CaptureID yalnızca gizli sayfaya işaret eder, dolayısıyla belleğin serbest bırakılması gerekmez
Sayfanın "media box" öğesi, yakalanan sayfanın sınırlayıcı dikdörtgeni olarak kullanılır. Bunun yerine sayfanın "crop box" öğesinin kullanılması gereken durumlarda CapturePage işlevi kullanılabilir
Sözdizimi
Delphi
Function TPDFlib.CapturePage(Page: Integer): Integer;
ActiveX
Function PDFlib::CapturePage(Page As Long) As Long
DLL
int DLCapturePage(int InstanceID, int Page);
Parametreler
| Page | Yakalanacak sayfa numarası. Belgedeki ilk sayfa, sayfa 1'dir |
|---|
Dönüş değerleri
| 0 | Belirtilen sayfa mevcut değil veya belgedeki tek sayfa |
|---|---|
| Non-zero | Yakalama sürecinin kimliği. Bu kimlik DrawCapturedPage işlevine sağlanmalıdır |