AddTextMarkupAnnotation

annotationها و hotspot linkها

توضیحات

یک حاشیه‌نویسی نشانه‌گذاری متن به صفحهٔ جاری اضافه می‌کند

به‌طور پیش‌فرض حاشیه‌نویسی از یک ناحیهٔ مستطیلی منفرد منطبق با کادر محاطی حاشیه‌نویسی تشکیل می‌شود؛ این ناحیه قابل ویرایش است و ناحیه‌های دیگر را می‌توان با توابع GetAnnotQuadCount، GetAnnotQuadPoints و SetAnnotQuadPoints اضافه کرد

وقتی سند انتخاب‌شده قدیمی‌تر از PDF 1.4 باشد، نویسنده نسخهٔ مؤثر PDF را به‌طور خودکار به 1.4 می‌برد چون این تابع مدخل کدری حاشیه‌نویسی /CA مربوط به PDF 1.4 را می‌نویسد

نحو

Delphi

Function TPDFlib.AddTextMarkupAnnotation(MarkupType: Integer; Left, Top, Width, Height: Double): Integer;

ActiveX

Function PDFlib::AddTextMarkupAnnotation(MarkupType As Long, Left As Double, Top As Double, Width As Double, Height As Double) As Long

DLL

int DLAddTextMarkupAnnotation(int InstanceID, int MarkupType, double Left, double Top, double Width, double Height);

پارامترها

MarkupType0 = Highlight؛ 1 = Underline؛ 2 = Squiggly؛ 3 = Strike out؛ مختصات افقی لبه چپ bounding box مربوط به annotation
Left
Topمختصات عمودی لبهٔ بالایی کادر محاطی حاشیه‌نویسی
Widthعرض کادر محاطی حاشیه‌نویسی
Heightارتفاع کادر محاطی حاشیه‌نویسی

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

0پارامتر MarkupType بین 1 و 4 نبود. annotation مربوط به text markup با موفقیت اضافه شد
1