BeginArtifactA

ملف PDF ذو بنية، إمكانية الوصول

الوصف

تشير اللاحقة A إلى نقطة دخول DLL بصيغة ANSI (char)؛ وتبقى واجهة ActiveX/COM مكشوفةً بالصيغة Unicode فقط. والسلوك مطابق لـ BeginArtifact وتُفسر وسائط السلاسل بصفحة شيفرة SetAnsiMode الحالية

يفتح منطقة عنصر PDF. ومحتوى العنصر زخرفي أو بنيوي (ترويسات الصفحات وتذييلاتها وأرقامها وصور الخلفية وخطوط المسطرة) ويستثنى صراحةً من ترتيب القراءة المنطقي للمستند. وتتخطى قارئات الشاشة مناطق العناصر كليًا

اكتب رسومات العنصر أو نصه بين BeginArtifact واستدعاء EndArtifact الموافق

الصيغة

Delphi

Function DLBeginArtifactA(InstanceID: Integer; SubType: PAnsiChar): Integer;

DLL

int DLBeginArtifactA(int InstanceID, const char * SubType);

المعاملات

SubType	اسم نوع فرعي للعنصر اختياري. القيم الشائعة: `Header` و`Footer` و`Watermark` و`Background`. مرِّر سلسلة فارغة لحذف النوع الفرعي

قيم الإرجاع

0	فشل (لا يوجد مستند مفتوح)
1	فُتحت منطقة العنصر بنجاح

مثال

// Page footer as artifact
PDF.BeginArtifact('Footer');
PDF.SetFontSize(8);
PDF.PrintText(50, 20, 'Page 1 of 10');
PDF.EndArtifact;