EndArtifact
Tagged PDF, Tilgængelighed
Beskrivelse
Lukker det senest åbnede artefaktområde og skriver en EMC-operator (End Marked Content) til den aktuelle sides indholdsstream. Hvert kald til BeginArtifact skal matches af præcis ét kald til EndArtifact.
Syntaks
Delphi
Function TPDFlib.EndArtifact: Integer;ActiveX
Function PDFlib::EndArtifact() As LongDLL
int DLEndArtifact(int InstanceID);Returværdier
| 0 | Mislykkedes — intet dokument er åbent, eller intet artefaktområde er åbent i øjeblikket |
|---|---|
| 1 | Artefaktområdet blev lukket |
Bemærkninger
Artefaktområder og strukturelementer deler den samme stak med mærket indhold for den aktuelle side. EndArtifact lukker kun det øverste åbne område, hvis det blev åbnet med BeginArtifact; brug det aldrig til at lukke et strukturelement, der er åbnet med BeginTag eller dets varianter — kald EndTag for disse.
Artefaktområder kan indlejres i strukturelementer, når artefaktet repræsenterer en dekorativ grafik, der visuelt hører til strukturelt indhold. De må dog ikke indeholde strukturelementer: PDF-læsere vil advare eller nægte at respektere struktur i et artefakt.
Typiske artefaktundertyper, der berettiger et separat område, er sidehoveder, sidefødder, sidetal, dekorative kanter, vandmærker og baggrundsbilleder. Når disse markeres som artefakter, holdes de ude af den læserækkefølge, som hjælpeteknologi præsenterer for brugeren
Eksempel
// 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;