EndArtifact
Tagged PDF, saavutettavuus
Kuvaus
Sulkee viimeisimmän avatun artifact-alueen kirjoittamalla EMC- (End Marked Content) operaattorin nykyisen sivun sisältövirtaan. Jokaisen BeginArtifact-kutsun on vastattava täsmälleen yksi EndArtifact-kutsu
Syntaksi
Delphi
Function TPDFlib.EndArtifact: Integer;ActiveX
Function PDFlib::EndArtifact() As LongDLL
int DLEndArtifact(int InstanceID);Paluuarvot
| 0 | Epäonnistui — mikään asiakirja ei ole avoinna tai mikään artifact-alue ei ole parhaillaan avoinna |
|---|---|
| 1 | Artifact-alueen sulkeminen onnistui |
Huomautukset
Artifact-alueet ja rakennetyylielementit jakavat saman marked content -pinon nykyisellä sivulla. EndArtifact sulkee vain ylimmän avoimen alueen, jos se avattiin funktiolla BeginArtifact; älä koskaan käytä sitä rakennetyylielementin sulkemiseen, joka avattiin funktiolla BeginTag
Artifact-alueita voi sisäkkäistää rakennetyylielementtien sisään, kun artifact esittää koristeellista grafiikkaa, joka kuuluu visuaalisesti rakenteellisen sisällön kanssa. Ne eivät kuitenkaan voi sisältää rakennetyylielementtejä: PDF-katselimet varoittavat tai kieltäytyvät kunnioittamasta rakennetta artifactin sisällä
Tyypillisiä artifact-alatyyppejä, jotka perustelevat erillisen alueen, ovat sivujen ylä- ja alatunnisteet, sivunumerot, koristeelliset reunukset, vesileimat ja taustakuvat. Niiden merkitseminen artifacteiksi pitää ne poissa lukujärjestyksestä, jonka avustava teknologia esittää käyttäjälle
Esimerkki
// 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;