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);