EndArtifact
Tagged PDF, נגישות
תיאור
סוגרת את אזור ה-artifact שנפתח לאחרונה, וכותבת אופרטור EMC (End Marked Content) אל זרם התוכן של הדף הנוכחי. לכל קריאה ל-BeginArtifact חייבת להיות התאמה של קריאת EndArtifact אחת בדיוק.
תחביר
Delphi
Function TPDFlib.EndArtifact: Integer;ActiveX
Function PDFlib::EndArtifact() As LongDLL
int DLEndArtifact(int InstanceID);ערכי החזרה
| 0 | Failed — no document is open or no artifact region is currently open. |
|---|---|
| 1 | אזור ה-artifact נסגר בהצלחה |
הערות
אזורי artifact ורכיבי מבנה חולקים את אותה מחסנית marked-content עבור העמוד הנוכחי. EndArtifact סוגר רק את האזור הפתוח העליון ביותר אם הוא נפתח עם BeginArtifact; לעולם אל תשתמשו בו כדי לסגור רכיב מבנה שנפתח עם BeginTag או וריאציות שלו — עבור אלה קראו ל-EndTag.
אזורי artifact יכולים להיות מקוננים בתוך אלמנטי מבנה כאשר ה-artifact מייצג גרפיקה דקורטיבית ששייכת חזותית לתוכן מבני; עם זאת אסור שיכילו אלמנטי מבנה: מציגי PDF יזהירו או יסרבו לכבד מבנה בתוך artifact
תתי-סוגים אופייניים של artifact שמצדיקים אזור נפרד הם כותרות עליונות ותחתונות של עמודים, מספרי עמודים, גבולות דקורטיביים, סימני מים ותמונות רקע. סימון אלה כ-artifacts שומר אותם מחוץ לסדר הקריאה שטכנולוגיה מסייעת מציגה למשתמש
דוגמה
// 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;