EndArtifact
PDF Terlabeli, Aksesibilitas
Deskripsi
Menutup region artifact yang paling akhir dibuka, menulis operator EMC (End Marked Content) ke content stream halaman saat ini. Setiap panggilan BeginArtifact harus dipasangkan dengan tepat satu panggilan EndArtifact
Sintaks
Delphi
Function TPDFlib.EndArtifact: Integer;ActiveX
Function PDFlib::EndArtifact() As LongDLL
int DLEndArtifact(int InstanceID);Nilai kembalian
| 0 | Gagal — tidak ada dokumen terbuka atau tidak ada region artifact yang sedang terbuka |
|---|---|
| 1 | Region artifact berhasil ditutup |
Catatan
Region artifact dan structure element berbagi stack marked-content yang sama untuk halaman saat ini. EndArtifact hanya menutup region terbuka paling atas jika ia dibuka dengan BeginArtifact; jangan pakai menutup structure element yang dibuka BeginTag atau variantnya — panggil EndTag untuk itu
Region artifact boleh bersarang di dalam structure element saat artifact merepresentasikan grafis dekoratif yang secara visual menyatu dengan konten struktural. Namun region artifact tidak boleh memuat structure element: PDF reader akan memperingatkan atau menolak menghormati struktur di dalam artifact
Subtipe artifact yang lazim dan membenarkan region terpisah adalah header halaman, footer, nomor halaman, border dekoratif, watermark, dan background image. Menandainya sebagai artifact menjauhkannya dari urutan baca yang disajikan teknologi assistive kepada pengguna
Contoh
// 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;