AttachComponent
Phần tài liệu, dữ liệu biến, soạn thảo tài liệu
Mô tả
Thay thế các ảnh chụp thành phần ban đầu và hiện tại của một TPDFlibDynamicComponentSession bằng các bản sao mới của thành phần do người gọi sở hữu và xóa sạch trạng thái tiến trình
Cú pháp
Function TPDFlibDynamicComponentSession.AttachComponent(
AComponent: TPDFlibDynamicComponent): Integer;
Tham số
AComponent | Thành phần do người gọi sở hữu mà CloneComponent của nó cung cấp cả ảnh chụp ban đầu mới lẫn ảnh chụp hiện tại mới |
|---|
Ghi chú
Cả hai bản sao được tạo trước khi bất kỳ ảnh chụp nào đang lưu được giải phóng, nên CloneComponent trả về Nil sẽ giữ nguyên thành phần trước đó, số lần ghép, cờ hoàn tất và trạng thái thử lại
Khi thành công, phiên giải phóng các ảnh chụp cũ, lưu cặp mới và đặt lại
CompositionCount về 0, cùng Completed, KeepTogetherRetryPending, LastRetryReason và LastRequiredSlotHeight
Phiên không bao giờ nhận quyền sở hữu
AComponent
AttachComponent; chỉ các bản sao được lưu, nên người gọi giữ và giải phóng thể hiện đã truyền một cách độc lập
Hàm dựng phiên gọi Nil, nên một phiên được tạo với thành phần
Ví dụ
Replacement := TNumberedPagesComponent.Create(1, 5);
try
if Session.AttachComponent(Replacement) = 1 then
Status := Session.ComposeNext(PageNumber, 36, 36, 540, 720,
Placement);
finally
Replacement.Free;
end;
Giá trị trả về
1 | Cả hai bản sao đã được tạo và ghi nhận làm ảnh chụp ban đầu và hiện tại mới với toàn bộ trạng thái tiến trình đã xóa |
|---|---|
0 | AComponent là Nil hoặc một trong các lời gọi CloneComponent trả về Nil, và các ảnh chụp cùng trạng thái trước đó được bảo toàn |
Xem thêm
TPDFlibDynamicComponentSession, TPDFlibDynamicComponent, CloneComponent, CloneCurrentComponent, ComposeNextLayout