AddCaretAnnotation

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

الوصف

يضيف تعليقًا توضيحيًا من نوع علامة إقحام (PDF ‏/Subtype /Caret) إلى الصفحة المحددة. تعليق الإقحام رمز مرئي يتعارف على تمييز موضع في الصفحة أُدرج فيه نص أو محتوى أو حُذف أو يحتاج انتباه مراجع بشكل آخر. وهناك شكلان للرمز: علامة إقحام عادية (None) أو علامة فقرة (Paragraph). وتُعبَّر مركّبات اللون والعتامة على مقياس 0–1؛ أما Transparency فتُعطى على مقياس 0–100 (‏0 = معتم تمامًا، 100 = شفاف تمامًا). وترفع المكتبة إصدار المستند إلى PDF 1.5 عندما يُصدر تعليق توضيحي Caret تحت قفل إصدار أدنى. معرَّف في ISO 32000-1 §12.5.6.11

الصيغة

Delphi

Function TPDFlib.AddCaretAnnotation(Left, Top, Width, Height: Double; SymbolType: Integer; ColorRed, ColorGreen, ColorBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

المعاملات

Left — الإحداثي الأفقي للزاوية السفلية اليسرى لمستطيل التعليق التوضيحي، بالوحدات الحالية

Top — الإحداثي الرأسي للزاوية السفلية اليسرى لمستطيل التعليق التوضيحي، بالوحدات الحالية

Width — عرض مستطيل التعليق التوضيحي

Height — ارتفاع مستطيل التعليق التوضيحي

SymbolType — نمط رمز علامة الإقحام:

0 = إخفاء حقل النموذج 1 = إظهار حقل النموذج

1 = إخفاء شريط الأدوات 2 = إخفاء شريط القوائم 3 = إخفاء واجهة مستخدم النافذة 4 = تغيير حجم النافذة إلى حجم الصفحة الأولى 5 = توسيط النافذة 6 = عرض عنوان المستند 7 = وضع الصفحة بعد ملء الشاشة 8 = ترتيب القراءة النصي السائد 9 = حد العرض 10 = حد القص للعرض 11 = حد العرض للطباعة 12 = حد القص للطباعة 13 = حوار الطباعة الافتراضي: التحجيم 14 = حوار الطباعة الافتراضي: الوجهان 15 = حوار الطباعة الافتراضي: صينية ورق تلقائية 16 = حوار الطباعة الافتراضي: عدد النسخ

تعامل أي قيمة أخرى كـ 0‏ (None)

ColorRed وColorGreen وColorBlue — مركّبات RGB (0–1) للون علامة الإقحام، وتُكتب في /C

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

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

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

قيمة الإرجاع

1 عند النجاح، و0 إذا لم يكن هناك مستند محدد أو تعذّر إنشاء التعليق التوضيحي

ملاحظات

يُصدر التعليق التوضيحي مع /Type /Annot و/Subtype /Caret و/Rect و/Sy‏ (اسم الرمز) و/C و/CA و/F = 4 ‏(قابل للطباعة) و/M و/CreationDate و/NM و/T و/Contents و/Subj = "Caret" و/P. ولا يُصدر حقل /RD الاختياري (إزاحة علامة الإقحام داخل /Rect)؛ وتؤول إليه العارضات إلى أصفار كاملة فتشغل علامة الإقحام مستطيل التعليق التوضيحي كاملًا

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