EndArtifact
Tagovaný PDF, prístupnosť
Opis
Zatvorí naposledy otvorenú oblasť artefaktu a do obsahového prúdu aktuálnej strany zapíše operátor EMC (End Marked Content). Každé volanie BeginArtifact musí presne jedno volanie EndArtifact sprevádzať.
Syntax
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 | Oblasť artefaktu sa úspešne zatvorila. |
Poznámky
Oblasti artefaktov a štruktúrne prvky zdieľajú ten istý zásobník marked-content aktuálnej strany. EndArtifact zatvorí najvyššiu otvorenú oblasť, iba ak bola otvorená cez BeginArtifact; nikdy ho nepoužívajte na zatvorenie štruktúrneho prvku otvoreného cez BeginTag alebo jeho varianty — na tie zavolajte EndTag.
Artifact regiony môžu byť vnorené vnútri štruktúrnych prvkov, keď artifact zastupuje dekoratívnu grafiku, ktorá vizuálne patrí k štruktúrnemu obsahu. Nesmú však obsahovať štruktúrne prvky: PDF čítačky budú varovať alebo odmietnuť rešpektovať štruktúru vnútri artifactu
Typické subtypy artifactov ospravedlňujúce samostatnú oblasť sú hlavičky a päty stránok, čísla stránok, dekoratívne okraje, vodoznaky a obrázky na pozadí. Označenie týchto vecí za artifacty ich drží mimo poradia čítania, ktoré asistívna technológia predkladá používateľovi
Prí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;