AddLineAnnotation

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

الوصف

يضيف تعليقًا توضيحيًا من نوع خط (PDF ‏/Subtype /Line) بين نقطتي نهاية على الصفحة المحددة. ويمكن أن يحمل كل طرف نمط خط نهاية مختلفًا (سهم أو مربع أو دائرة أو معين …) ويمكن رسم متن الخط بأي لون RGB مع عتامة قابلة للضبط. ويمكن اختياريًا تعبئة زخارف النهاية ذات الداخل (ClosedArrow وSquare وCircle وDiamond). ولأن نقطة الدخول هذه تصدر مفتاح عتامة التعليق التوضيحي /CA الخاص بـ PDF 1.4، ترفع المكتبة المستندات الأدنى غير المقفلة إلى PDF 1.4 قبل الحفظ؛ وترفض بوابة التوافق الأهداف الأدنى المقفلة. معرَّف في ISO 32000-1 §12.5.6.7

الصيغة

Delphi

Function TPDFlib.AddLineAnnotation(StartLeft, StartTop, EndLeft, EndTop: Double; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

المعاملات

StartLeft وStartTop — إحداثيات نقطة نهاية بداية الخط، بالوحدات الحالية

EndLeft وEndTop — إحداثيات نقطة نهاية الخط، بالوحدات الحالية

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 عند النجاح، و0 إذا لم يكن هناك مستند محدد أو تعذّر إنشاء التعليق التوضيحي

ملاحظات

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

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

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