AddPolyLineAnnotation

التعليقات التوضيحية وروابط النقاط الفعالة

الوصف

يضيف تعليقًا توضيحيًا من نوع خط متعدد الرؤوس مفتوح (PDF ‏/Subtype /PolyLine) إلى الصفحة المحددة بقائمة الرؤوس المقدمة. وخط الرؤوس مفتوح — لا تصل القارئات آخر رأس بأول رأس — ويمكن أن يحمل أنماط خط نهاية مختلفة عند كل طرف نهائي. ويمكن اختياريًا تعبئة زخارف النهاية ذات الداخل (ClosedArrow وSquare وCircle وDiamond). وتُعبَّر مركّبات اللون والعتامة على مقياس 0–1؛ أما Transparency فتُعطى على مقياس 0–100 (‏0 = معتم تمامًا، 100 = شفاف تمامًا). وترفع المكتبة إصدار المستند إلى PDF 1.5 عندما يُصدر تعليق توضيحي PolyLine تحت قفل إصدار أدنى. معرَّف في ISO 32000-1 §12.5.6.9

الصيغة

Delphi

Function TPDFlib.AddPolyLineAnnotation(Const VertexCoords: WideString; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

المعاملات

VertexCoords — إحداثيات الرؤوس كسلسلة واحدة من قيم x/y متبادلة مفصولة بمسافات أو فواصل أو فواصل منقوطة أو جدولات. مثال: "100 100 200 150 300 100" يعرّف شكل V. تتطلب زوجين على الأقل (أربعة أعداد) وعددًا كليًا زوجيًا من الأعداد، وإلا يُرجع الاستدعاء 0

BorderWidth — عرض حد خط الرؤوس وزخارف نهايته، بالوحدات الحالية

LineRed وLineGreen وLineBlue — مركّبات RGB (0–1) للون الخط، وتُكتب في /C

StartStyle وEndStyle — أنماط نهاية الخط للرأسين الأول والأخير على التوالي. استخدم أحدها:

0 = None, 1 = Square, 2 = Circle, 3 = Diamond, 4 = OpenArrow, 5 = ClosedArrow, 6 = Butt, 7 = ROpenArrow, 8 = RClosedArrow, 9 = Slash.

تُقيَّد القيم خارج النطاق إلى 0‏ (None)

Filled — القيمة 1 لإصدار لون تعبئة داخلي (/IC) للزخارف الختامية، والقيمة 0 لتركها بلا تعبئة

FillRed وFillGreen وFillBlue — مركّبات RGB (0–1) للون تعبئة الزخرفة الختامية الداخلي. تُتجاهل عندما تساوي Filled القيمة 0

Title — اسم المؤلف الذي يُكتب في مدخل /T الخاص بالتعليق التوضيحي. مرِّر سلسلة فارغة لتجاهله

Contents — متن النافذة المنبثقة المرتبطة بالتعليق التوضيحي. مرِّر سلسلة فارغة لتجاهله

Transparency — العتامة معبَّرًا عنها كنسبة مئوية للشفافية (0–100). تحوّلها المكتبة إلى ‎/CA = 1 - Transparency/100 في PDF مع تقييدها ضمن النطاق

قيمة الإرجاع

1 = مدّ التظليل باستخدام لون صلب

ملاحظات

يُحسب /Rect للتعليق التوضيحي تلقائيًا من مدى الرؤوس زائدًا حشوًا متناسبًا مع عرض الإطار فتبقى زخارف النهاية داخل الصندوق المحيط للتعليق التوضيحي

حقول متقدمة اختيارية تصفها مواصفة PDF — ‏/IT (القصد، شاملًا PolyLineDimension) و/Measure — لا تصدرها نقطة الدخول هذه. ويمكن إلحاقها بعد الإنشاء بكتابتها على قاموس التعليق التوضيحي مباشرةً

لكتابة لون الخط أو الإطار أو المحتويات أو المستطيل فوق ما أُنشئ، استخدم SetAnnotBorderColor وSetAnnotBorderStyle وSetAnnotContents وSetAnnotRect