CapturePage

Thao tác trang

Mô tả

Hàm này "capture" một trang. Sau khi trang đã được capture, nó vẽ được lên các trang khác. Điều này hữu ích khi ghép các trang khác nhau hoặc đặt nhiều hơn một trang gốc lên một trang khác (imposition). Trang sau khi capture bị xóa khỏi tài liệu. Nếu muốn trang còn ở lại, bạn phải tạo một trang trắng rồi vẽ trang đã capture lên trang trắng đó

Ngoài ra, vì tài liệu phải luôn có ít nhất một trang nên không thể capture một trang nếu đó là trang duy nhất trong tài liệu. Trong trường hợp này, bạn phải thêm một trang trắng mới trước khi trang hiện có được capture

Không thể dùng CapturePage để chuyển trang sang một tài liệu mới khác, nên mọi trang cần dùng phải được gộp vào một tài liệu duy nhất trước khi gọi CapturePage. CaptureID chỉ là pointer tới một trang ẩn nên không cần giải phóng memory

"Media box" của trang được dùng làm hình chữ nhật bao cho trang đã capture. Khi cần dùng "crop box" của trang thay thế, hãy dùng hàm CapturePage

Cú pháp

Delphi

Function TPDFlib.CapturePage(Page: Integer): Integer;

ActiveX

Function PDFlib::CapturePage(Page As Long) As Long

DLL

int DLCapturePage(int InstanceID, int Page);

Tham số

PageSố trang cần capture. Trang đầu tiên trong tài liệu là trang 1

Giá trị trả về

0Trang chỉ định không tồn tại, hoặc là trang duy nhất trong tài liệu
Non-zeroID của quy trình capture. ID này phải truyền cho hàm DrawCapturedPage