AddSquareAnnotation

annotationها و hotspot linkها

توضیحات

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

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 /Square، /Rect، /C، /IC (وقتی Filled)، /BS، /Border، /CA، /F = 4 (قابل چاپ)، /M، /CreationDate، /NM، /T، /Contents، /Subj = "Rectangle"، /P. این با خروجی ابزارهای بازبینی مستطیل Adobe Acrobat و Foxit مطابقت دارد، پس گردش‌کارهای بازبینی بیرونی می‌توانند حاشیه‌نویسی حاصل را پیدا، ویرایش، کامنت‌گذاری و پاسخ کنند

برای overwrite کردن rectangle، color، contents یا border مربوط به annotation پس از creation، از SetAnnotRect، SetAnnotBorderColor، SetAnnotContents و SetAnnotBorderStyle استفاده کنید