EndArtifact
PDF etichetat, Accesibilitate
Descriere
Închide cea mai recentă regiune de artifact deschisă, scriind un operator EMC (End Marked Content) în content stream-ul paginii curente. Fiecare apel BeginArtifact trebuie potrivit cu exact un apel EndArtifact
Sintaxă
Delphi
Function TPDFlib.EndArtifact: Integer;ActiveX
Function PDFlib::EndArtifact() As LongDLL
int DLEndArtifact(int InstanceID);Valori returnate
| 0 | Eșec — niciun document nu este deschis sau nicio regiune de artefact nu este deschisă momentan |
|---|---|
| 1 | Regiunea artifact a fost închisă cu succes |
Observații
Regiunile de artefact și elementele de structură partajează aceeași stivă de marked-content pentru pagina curentă. EndArtifact închide doar regiunea deschisă cea mai de sus dacă a fost deschisă cu BeginArtifact; nu-l folosiți niciodată pentru a închide un element de structură deschis cu BeginTag sau variantele lui — pentru acelea apelați EndTag
Regiunile artifact pot fi imbricate în interiorul elementelor de structură când artifact-ul reprezintă o grafică decorativă care aparține vizual conținutului structural. Nu pot însă conține elemente de structură: reader-ele PDF vor avertiza sau vor refuza să onoreze structura din interiorul unui artifact
Subtipuri tipice de artifact care justifică o regiune separată sunt antetele de pagină, subsolurile, numerele de pagină, chenarele decorative, watermark-urile și imaginile de fundal. Marcarea lor ca artifact îi ține în afara ordinii de citire pe care tehnologia asistivă o prezintă utilizatorului
Exemplu
// 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;