AddSquareAnnotation

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

الوصف

يضيف تعليقًا توضيحيًا من نوع مستطيل (PDF ‏/Subtype /Square) إلى الصفحة المحددة. يرسم التعليق التوضيحي مستطيلًا محددًا بالحدود محشورًا في المستطيل المحيط المعطى ويمكن اختياريًا تعبئته بلون داخلي مصمت. وتُعبَّر مركّبات اللون والعتامة على مقياس 0–1؛ أما Transparency فتُعطى على مقياس 0–100 (‏0 = معتم تمامًا، 100 = شفاف تمامًا). ولأن نقطة الدخول هذه تصدر مفتاح عتامة التعليق التوضيحي /CA الخاص بـ PDF 1.4، ترفع المكتبة المستندات الأدنى غير المقفلة إلى PDF 1.4 قبل الحفظ؛ وترفض بوابة التوافق الأهداف الأدنى المقفلة. معرَّف في ISO 32000-1 §12.5.6.8

الصيغة

Delphi

Function TPDFlib.AddSquareAnnotation(Left, Top, Width, Height: Double; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

المعاملات

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

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

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

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

BorderWidth — عرض حد المستطيل، بالوحدات الحالية. ويُكتب في حقل /Border القديم وقاموس نمط الحدود /BS معًا

قناع بتات يتحكم في مظهر الارتباط. البت 0 (القيمة 1): رسم إطار حول مستطيل النقطة الساخنة. وتختار البتات 1–3 نمط تمييز النقر (2 = Invert، 4 = Outline، 8 = Push)؛ وعند عدم تعيين أي بت تمييز يُستخدم Invert كافتراضي

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

ملاحظات

يُصدر التعليق التوضيحي بمجموعة حقول وسْم قياسية: /Type /Annot و/Subtype /Square و/Rect و/C و/IC‏ (عندما يكون Filled) و/BS و/Border و/CA و/F = 4 ‏(قابل للطباعة) و/M و/CreationDate و/NM و/T و/Contents و/Subj = "Rectangle" و/P. وهذا يطابق ما ينتجه Adobe Acrobat وFoxit لأدوات مراجعة المستطيل لديهما، فيمكن لسير عمل المراجعة الخارجي تحديد موقع التعليق التوضيحي الناتج وتحريره والتعليق عليه والرد عليه

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