AddCircleAnnotation

annotationها و hotspot linkها

توضیحات

حاشیه‌نویسی نشانه‌گذاری بیضوی (یعنی 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 نوشته می‌شود

BorderRed، BorderGreen، BorderBlue — مؤلفه‌های RGB (0–1) رنگ خط، که در /C نوشته می‌شوند

Filled — 1 برای درج رنگ پرکنندهٔ داخلی (/IC)، 0 برای رها کردن بیضی بدون پرکننده

FillRed، FillGreen، FillBlue — مؤلفه‌های RGB (0–1) رنگ پرکنندهٔ داخلی؛ وقتی Filled صفر است نادیده گرفته می‌شوند

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 استفاده کنید