CapturePageEx

Sayfa işleme

Açıklama

Bu işlev bir sayfayı "yakalar". Sayfa yakalandıktan sonra başka sayfalara çizilebilir. Bu, farklı sayfaları birleştirmek veya birden fazla özgün sayfayı başka bir sayfaya yerleştirmek (imposisyon) 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ı bu boş sayfaya çizmelisiniz.

Ayrıca bir belgenin her an en az bir sayfası olması gerektiğinden, belgedeki tek sayfa ise o sayfayı yakalamak mümkün değildir. Bu durumda mevcut sayfayı yakalayabilmek için önce yeni bir boş sayfa eklemelisiniz.

CapturePageEx yakalanan sayfayı geçerli belgeden kaldırır; kaynak sayfayı korumak veya başka bir açık belgeden içe aktarmak için ImportPageAsFormXObject kullanın

Sayfanın "media box"ı yakalanan sayfanın sınırlayıcı dikdörtgeni olarak kullanılır. Bunun yerine sayfanın "crop box"ı kullanılacaksa CapturePageEx işlevi kullanılabilir.

Sözdizimi

Delphi

Function TPDFlib.CapturePageEx(Page, Options: Integer): Integer;

ActiveX

Function PDFlib::CapturePageEx(Page As Long, Options As Long) As Long

DLL

int DLCapturePageEx(int InstanceID, int Page, int Options);

Parametreler

PageYakalanacak sayfa numarası. Belgedeki ilk sayfa 1. sayfadır
Options0 = Sınırlayıcı dikdörtgen için sayfanın media box değerini kullan 1 = Varsa sınırlayıcı dikdörtgen için sayfanın crop box değerini kullan, yoksa media box değerini kullan 2 = Varsa sınırlayıcı dikdörtgen için sayfanın bleed box değerini kullan, yoksa crop box değerini kullan 3 = Varsa sınırlayıcı dikdörtgen için sayfanın trim box değerini kullan, yoksa crop box değerini kullan 4 = Varsa sınırlayıcı dikdörtgen için sayfanın art box değerini kullan, yoksa crop box değerini kullan

Dönüş değerleri

0Belirtilen sayfa yok veya belgedeki tek sayfa
Non-zeroYakalama işleminin kimliği. Bu kimlik DrawCapturedPage işlevine verilmelidir