AddFreeTextAnnotationExA
Text, Annotations and hotspot links
الوصف
تشير اللاحقة A إلى نقطة دخول DLL بصيغة ANSI (char)؛ وتبقى واجهة ActiveX/COM مكشوفةً بالصيغة Unicode فقط. والسلوك مطابق لـ AddFreeTextAnnotationEx وتُفسر وسائط السلاسل بصفحة شيفرة SetAnsiMode الحالية
يضيف تعليقًا توضيحيًا من نوع نص حر إلى الصفحة المحددة. إذا حُدد إطار و/أو تعبئة بالمعامل Options فتُجلب الإعدادات من لون الخط الحالي ولون التعبئة وعرض الخط وإعدادات تنقيط القلم
SetLineColor لا تؤثر في لون الإطار. ولون الإطار مضبوط حاليًا على لون النص نفسه بسبب طريقة عمل Acrobat. وSelectFont لا تؤثر في نمط الخط. والخط مضبوط حاليًا برمجيًا على الخط القياسي Helvetica بسبب طريقة عمل Acrobat
يؤثر SetTextSize في حجم النص على نحو صحيح ويؤثر SetTextColor في لون النص على نحو صحيح ويضبط SetLineWidth عرض الحد على نحو صحيح ويضبط SetTextAlign محاذاة النص على نحو صحيح
عندما يكون المستند المحدد أقدم من PDF 1.4، يرفع الكاتب إصدار PDF الفعلي تلقائيًا إلى 1.4 لأن هذه الدالة تكتب مدخل عتامة التعليق التوضيحي /CA الخاص بـ PDF 1.4
Syntax
Delphi
Function DLAddFreeTextAnnotationExA(InstanceID: Integer; Left, Top, Width, Height: Double; Text: PAnsiChar; Angle, Options, Transparency: Integer): Integer;
DLL
int DLAddFreeTextAnnotationExA(int InstanceID, double Left, double Top, double Width, double Height, const char * Text, int Angle, int Options, int Transparency);
Parameters
| Left | الإحداثي الأفقي للحافة اليسرى لمستطيل التعليق التوضيحي |
|---|---|
| Top | الإحداثي الرأسي للحافة اليسرى لمستطيل التعليق التوضيحي |
| Width | عرض مستطيل التعليق التوضيحي |
| Height | ارتفاع مستطيل التعليق التوضيحي |
| Text | المحتوى النصي للتعليق التوضيحي |
| Angle | زاوية النص المرسوم. يمكن أن تكون 0 أو 90 أو 180 أو 270 0 = مخطط 1 = تعبئة 2 = تعبئة ومخطط |
| Options | |
| Transparency | مقدار الشفافية المطبقة 0 = بلا شفافية 50 = شفافية 50% 100 = غير مرئي int Options, int Transparency); |