Compose
Bố cục trang, phân trang, Form XObject
Mô tả
Phương thức trừu tượng của TPDFlibDynamicComponent vẽ một mảnh của thành phần theo tọa độ cục bộ và báo các cận dùng cùng trạng thái tiếp diễn của nó
Cú pháp
Function TPDFlibDynamicComponent.Compose(
Const Context: TPDFlibDynamicPageContext;
Out ComposeResult: TPDFlibDynamicPageResult): Integer;
Virtual; Abstract;
Tham số
Context.LibraryInstance | Thể hiện TPDFlib đã gắn mà mảnh sẽ vẽ qua đó |
|---|---|
Context.PageNumber | Số trang đích mặc dù thư viện chọn một trang tạm cô lập trong khi callback chạy |
Context.CompositionIndex | Số tính từ 1 mà mảnh nhận được khi nó được ghi nhận |
Context.DestinationLeft, Context.DestinationTop | Vị trí slot đích truyền thẳng từ lời gọi ghép |
Context.AvailableWidth, Context.AvailableHeight | Kích thước canvas tự nhiên của Form XObject bao quanh |
Bản ghi kết quả
HasContent | True khi mảnh đã vẽ nội dung hiển thị được |
|---|---|
HasMoreContent | True khi thành phần có thể sinh thêm một mảnh nữa |
UsedWidth, UsedHeight | Hình chữ nhật dùng bắt đầu tại tọa độ cục bộ 0 và phải bao trọn mọi nội dung thành phần hiển thị được |
Ghi chú
Kết quả có nội dung yêu cầu các giá trị UsedWidth và UsedHeight hữu hạn dương trong AvailableWidth và AvailableHeight
Kết quả không nội dung chỉ hợp lệ khi
HasMoreContent là False và cả hai chiều dùng đều bằng 0
Callback có thể dùng các API vẽ và nội dung nhưng không được đổi tài liệu, trang hay các bộ chứa vẽ lồng nhau
Phiên xác thực
Callback được dùng API vẽ và nội dung nhưng không được đổi tài liệu, trang hay container vẽ lồng nhau
ComposeResult qua ValidComposeResult trước khi đưa ra bất kỳ quyết định đặt nào
Trả về 0 sẽ từ chối lần thử mà không ghi nhận trạng thái thành phần hay đích; ngoại lệ phát sinh được lan truyền sau khi phiên đã dọn trạng thái tạm
Trả về không sẽ từ chối lần thử mà không commit trạng thái component hay đích; exception được đưa lên sau khi session đã dọn trạng thái tạm
Giá trị trả về
1 | Kết quả mảnh được đưa ra để xác thực và đặt |
|---|---|
0 | Lần thử bị từ chối và không có trạng thái thành phần hay đích nào thay đổi |
Xem thêm
TPDFlibDynamicComponent, TPDFlibDynamicPageContext, TPDFlibDynamicPageResult, ValidComposeResult, ComposeNextLayout, CloneComponent