EndArtifact
Tagged PDF, Barrierefreiheit
Beschreibung
Schließt den zuletzt geöffneten Artefaktbereich und schreibt einen Operator EMC (End Marked Content) in den Inhaltsstream der aktuellen Seite. Jeder Aufruf von BeginArtifact muss mit genau einem Aufruf von EndArtifact gepaart werden.
Syntax
Delphi
Function TPDFlib.EndArtifact: Integer;ActiveX
Function PDFlib::EndArtifact() As LongDLL
int DLEndArtifact(int InstanceID);Rückgabewerte
| 0 | Fehlgeschlagen — es ist kein Dokument oder derzeit kein Artefaktbereich geöffnet. |
|---|---|
| 1 | Der Artefaktbereich wurde erfolgreich geschlossen. |
Anmerkungen
Artefaktbereiche und Strukturelemente verwenden denselben Stack markierter Inhalte für die aktuelle Seite. EndArtifact schließt den obersten offenen Bereich nur, wenn er mit BeginArtifact geöffnet wurde; verwenden Sie es niemals zum Schließen eines mit BeginTag oder dessen Varianten geöffneten Strukturelements — rufen Sie dafür EndTag auf
Artefaktbereiche dürfen in Strukturelementen verschachtelt werden, wenn das Artefakt eine dekorative Grafik darstellt, die visuell zu strukturellem Inhalt gehört. Sie dürfen jedoch keine Strukturelemente enthalten: PDF-Reader warnen oder verweigern die Berücksichtigung von Struktur innerhalb eines Artefakts
Typische Artefaktuntertypen, die einen eigenen Bereich rechtfertigen, sind Kopfzeilen, Fußzeilen, Seitennummern, dekorative Rahmen, Wasserzeichen und Hintergrundbilder. Wenn diese als Artefakte markiert werden, bleiben sie außerhalb der Lesereihenfolge, die Hilfstechnologien dem Benutzer präsentieren.
Beispiel
// 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;