EndArtifact
Тагнат PDF, Достъпност
Описание
Затваря най-скоро отворената област на артефакт, като записва оператор EMC (End Marked Content) в потока със съдържание на текущата страница. Всяко извикване на BeginArtifact трябва да бъде съпоставено с точно едно извикване на EndArtifact
Синтаксис
Delphi
Function TPDFlib.EndArtifact: Integer;ActiveX
Function PDFlib::EndArtifact() As LongDLL
int DLEndArtifact(int InstanceID);Върнати стойности
| 0 | Неуспех — няма отворен документ или в момента няма отворена област на артефакт |
|---|---|
| 1 | Областта на артефакт беше затворена успешно |
Бележки
Областите на артефакти и структурните елементи споделят един и същ стек на маркирано съдържание за текущата страница. EndArtifact затваря само най-горната отворена област, ако е била отворена с BeginArtifact; никога не го използвайте, за да затворите структурен елемент, отворен с BeginTag или неговите варианти — за това извикайте EndTag
Областите на артефакти могат да бъдат вложени в структурни елементи, когато артефактът представлява декоративна графика, която визуално принадлежи към структурно съдържание. Те обаче не могат да съдържат структурни елементи: PDF четците ще изведат предупреждение или ще откажат да зачитат структура вътре в артефакт
Типични подтипове на артефакти, които оправдават отделна област, са горни колонтитули, долни колонтитули, номера на страници, декоративни рамки, водни знаци и фонови изображения. Маркирането им като артефакти ги изключва от реда на четене, който помощната технология представя на потребителя
Пример
// 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;