EndArtifact
Tagged PDF, Přístupnost
Popis
Zavře naposledy otevřenou oblast artifact a zapíše operátor EMC (End Marked Content) do obsahového proudu aktuální stránky. Každé volání BeginArtifact musí mít přesně jedno párové volání EndArtifact
Syntaxe
Delphi
Function TPDFlib.EndArtifact: Integer;ActiveX
Function PDFlib::EndArtifact() As LongDLL
int DLEndArtifact(int InstanceID);Návratové hodnoty
| 0 | Failed — no document is open or no artifact region is currently open. |
|---|---|
| 1 | Oblast artifact se úspěšně zavřela |
Poznámky
Artifact regions and structure elements share the same marked-content stack for the current page. EndArtifact only closes the topmost open region if it was opened with BeginArtifact; never use it to close a structure element opened with BeginTag or its variants — call EndTag for those.
Oblasti artifact se můžou vnořovat do strukturních prvků, když artifact představuje dekorativní grafiku, která vizuálně patří ke strukturnímu obsahu. Nesmí ale samy obsahovat strukturní prvky: PDF čtečky budou varovat nebo odmítnou respektovat strukturu uvnitř artifactu
Typické subtypy artifact ospravedlňující samostatnou oblast jsou záhlaví a zápatí stránek, čísla stránek, dekorativní okraje, vodoznaky a obrázky pozadí. Označení těchto prvků za artifact je drží mimo čtecí pořadí, které asistivní technologie předkládá uživateli
Příklad
// 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;