AddPolygonAnnotation

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

الوصف

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

الصيغة

Delphi

Function TPDFlib.AddPolygonAnnotation(Const VertexCoords: WideString; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

المعاملات

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

BorderWidth — عرض حد مخطط المضلع، بالوحدات الحالية

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

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 — ‏/BE (تأثير الإطار، شاملًا نمط الحدود الغائمة) و/IT (القصد، شاملًا PolygonCloud وPolygonDimension) و/Measure — لا تصدرها نقطة الدخول هذه. ويمكن إلحاقها بعد الإنشاء بكتابتها على قاموس التعليق التوضيحي مباشرةً

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