AddPolygonAnnotation

annotationها و hotspot linkها

توضیحات

یک markup annotation از نوع polygon بسته (PDF /Subtype /Polygon) را با فهرست vertexهای ارائه‌شده به صفحه انتخاب‌شده اضافه می‌کند. polygon به‌صورت ضمنی بسته است — readerها هنگام render آخرین vertex را به اولین vertex وصل می‌کنند. شکل را می‌توان به‌صورت اختیاری با یک رنگ داخلی یکدست پر کرد. مؤلفه‌های رنگ و opacity برحسب مقیاس 0–1 بیان می‌شوند؛ Transparency برحسب مقیاس 0–100 داده می‌شود (0 = کاملاً opaque، 100 = کاملاً transparent). وقتی annotation از نوع Polygon زیر یک قفل حداقل نسخه پایین‌تر تولید شود، کتابخانه نسخه سند را به PDF 1.5 افزایش می‌دهد. در ISO 32000-1 §12.5.6.9 تعریف شده است

نحو

Delphi

Function TPDFlib.AddPolygonAnnotation(Const VertexCoords: WideString; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

پارامترها

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

BorderWidth — عرض خط دورخط چندضلعی، در واحدهای جاری

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 اگر سندی انتخاب نشده باشد، رشتهٔ vertex قابل تجزیه نباشد یا حاشیه‌نویسی قابل ایجاد نباشد

ملاحظات

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

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

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