AddPolyLineAnnotation

annotationها و hotspot linkها

توضیحات

حاشیه‌نویسی نشانه‌گذاری چندخطی باز (یعنی PDF /Subtype /PolyLine) با فهرست رأس داده‌شده به صفحهٔ انتخاب‌شده اضافه می‌کند. چندخطی باز است — خواننده‌ها آخرین رأس را به اولی وصل نمی‌کنند — و می‌تواند سبک خط‌های انتهایی متفاوتی در هر نقطهٔ انتهایی حمل کند. تزئینات انتهایی که داخل دارند (ClosedArrow، Square، Circle، Diamond) می‌توانند اختیاری پر شوند. مؤلفه‌های رنگ و کدری در مقیاس 0–1 بیان می‌شوند؛ Transparency در مقیاس 0–100 داده می‌شود (0 = کاملاً مات، 100 = کاملاً شفاف). کتابخانه وقتی حاشیه‌نویسی PolyLine زیر قفل نسخهٔ حداقلی پایین‌تری صادر شود نسخهٔ سند را به PDF 1.5 می‌برد. تعریف‌شده در ISO 32000-1 §12.5.6.9

نحو

Delphi

Function TPDFlib.AddPolyLineAnnotation(Const VertexCoords: WideString; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

پارامترها

VertexCoords — مختصات رأس‌ها به‌صورت یک رشتهٔ واحد از مقادیر متناوب x/y جداشده با فاصله، کاما، سمی‌کالن یا tab. مثال: "100 100 200 150 300 100" شکل V تعریف می‌کند. دست‌کم دو جفت (چهار عدد) و تعداد کل زوجی از اعداد لازم است، وگرنه فراخوانی 0 برمی‌گرداند

BorderWidth — عرض خط شکسته و تزئینات انتهایی‌اش، در واحدهای جاری

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

StartStyle، EndStyle — سبک‌های انتهای خط به‌ترتیب برای اولین و آخرین رأس. یکی از این‌ها را به‌کار ببرید:

0 = هیچ، 1 = مربع، 2 = دایره، 3 = لوزی، 4 = پیکان باز، 5 = پیکان بسته، 6 = صاف، 7 = پیکان باز معکوس، 8 = پیکان بسته معکوس، 9 = مورب

مقادیر خارج از بازه به 0 (هیچ) محدود می‌شوند

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

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

Title — نام نویسنده‌ای که در مدخل /T حاشیه‌نویسی نوشته می‌شود؛ برای رد کردن، رشتهٔ خالی بدهید

Contents — متن پاپ‌آپ مرتبط با حاشیه‌نویسی؛ برای رد کردن، رشتهٔ خالی بدهید

Transparency — میزان کدری بر حسب درصد شفافیت (0–100)؛ کتابخانه این مقدار را به /CA = 1 - Transparency/100 در PDF تبدیل و به بازه مقید می‌کند

مقدار بازگشتی

در صورت موفقیت 1، و 0 اگر سندی انتخاب نشده باشد، رشتهٔ vertex قابل تجزیه نباشد یا حاشیه‌نویسی قابل ایجاد نباشد

ملاحظات

مدخل /Rect حاشیه‌نویسی به‌طور خودکار از وسع رأس‌ها به‌علاوهٔ لایی متناسب با عرض قاب محاسبه می‌شود تا تزئینات انتهایی درون کادر محاطی حاشیه‌نویسی بمانند

فیلدهای پیشرفتهٔ اختیاری توصیف‌شده در مشخصات PDF — /IT (قصد، شامل PolyLineDimension) و /Measure — توسط این نقطهٔ ورود صادر نمی‌شوند. می‌توان آن‌ها را پس از ساخت با نوشتن مستقیم روی دیکشنری حاشیه‌نویسی اضافه کرد

برای بازنویسی رنگ خط، قاب، محتوا یا مستطیل پس از ساخت از SetAnnotBorderColor، SetAnnotBorderStyle، SetAnnotContents و SetAnnotRect استفاده کنید