AddCircleAnnotation

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

الوصف

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

الصيغة

Delphi

Function TPDFlib.AddCircleAnnotation(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 /Circle و/Rect و/C و/IC‏ (عندما يكون Filled) و/BS و/Border و/CA و/F = 4 ‏(قابل للطباعة) و/M و/CreationDate و/NM و/T و/Contents و/Subj = "Ellipse" و/P. وهذا يطابق ما ينتجه Adobe Acrobat وFoxit لأدوات مراجعة القطع الناقص لديهما، فيمكن لسير عمل المراجعة الخارجي تحديد موقع التعليق التوضيحي الناتج وتحريره والتعليق عليه والرد عليه

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