EndArtifact
PDF có gắn thẻ, Khả năng tiếp cận
Mô tả
Đóng vùng artifact được mở gần nhất, ghi một toán tử EMC (End Marked Content) vào content stream của trang hiện tại. Mỗi lần gọi BeginArtifact phải được bù bằng đúng một lần gọi EndArtifact
Cú pháp
Delphi
Function TPDFlib.EndArtifact: Integer;ActiveX
Function PDFlib::EndArtifact() As LongDLL
int DLEndArtifact(int InstanceID);Giá trị trả về
| 0 | Failed — no document is open or no artifact region is currently open. |
|---|---|
| 1 | Đã đóng vùng artifact thành công |
Ghi chú
Vùng artifact và phần tử cấu trúc dùng chung một ngăn xếp marked-content cho trang hiện tại. EndArtifact chỉ đóng vùng đang mở trên cùng nếu nó được mở bằng BeginArtifact; đừng bao giờ dùng nó để đóng phần tử cấu trúc mở bằng BeginTag hoặc biến thể – những trường hợp đó hãy gọi EndTag.
Vùng artifact có thể lồng bên trong structure element khi artifact là hình trang trí thuộc về mặt thị giác với nội dung cấu trúc. Tuy nhiên chúng không được chứa structure element: các PDF reader sẽ cảnh báo hoặc từ chối tôn trọng cấu trúc bên trong artifact
Các subtype artifact điển hình đáng được vùng riêng là header, footer, số trang, viền trang trí, watermark và ảnh nền. Đánh dấu chúng là artifact giữ chúng khỏi thứ tự đọc mà công nghệ hỗ trợ trình bày cho người dùng
Ví dụ
// Running footer drawn once per page, as an artifact
PDF.BeginArtifact('Footer');
PDF.SetFontSize(8);
PDF.PrintText(50, 30, 'Annual Report 2026 — page ' + IntToStr(pageNo));
PDF.EndArtifact;
// Page header with the company logo, also an artifact
PDF.BeginArtifact('Header');
PDF.DrawImage(50, 800, 60, 30, logoHandle);
PDF.EndArtifact;