|
THPDFPage Advanced Methods
این صفحه روشهای سطح صفحه را که در THPDFPage عمومی هستند و در گردشکارهای پیشرفتهٔ تولید محتوا مفیدند گردآوری میکند، اما هنوز صفحهٔ موضوعی جداگانه ندارند
نشانهگذاری و حاشیهنویسیهای غنی
| روش |
کاربرد |
AddHighlightAnnotation, AddUnderlineAnnotation, AddSquigglyAnnotation, AddStrikeOutAnnotation |
حاشیهنویسیهای نشانهگذاری متن را روی یک بازهٔ مستطیلی از متن ایجاد میکند. HotPDF زیرنوع متناظر PDF 1.7 را صادر میکند و /QuadPoints را از مستطیل استخراج میکند |
AddPolylineAnnotation, AddPolygonAnnotation |
حاشیهنویسیهای بازبینی چندخطی یا چندضلعی PDF 1.7 را از یک آرایه از رأسهای THPDFCurrPoint ایجاد میکند. بارگذاریهای دارای THPDFPolyExtras رنگ داخلی اختیاری، حاشیهٔ ابری، intent و جزئیات پایان خط را اضافه میکنند |
HPDFDefaultLineExtras, HPDFDefaultPolyExtras |
رکوردهای صفر-مقداردهیشدهٔ THPDFLineExtras و THPDFPolyExtras را برمیگرداند تا فراخواننده فقط فیلدهای اختیاری خط یا چندضلعی موردنیاز را تنظیم کند |
AddInkAnnotation, AddCaretAnnotation |
نشانهگذاری بازبینی دستکشیده یا نشانگرهای درج caret را اضافه میکند. وقتی سبک حاشیه باید بعد از ایجاد تنظیم شود، از LastAnnotation همراه با SetAnnotationBorderStyle استفاده کنید |
AddScreenAnnotation, AddWatermarkAnnotation, AddRedactAnnotation |
حاشیهنویسیهای چندرسانهایِ screen، واترمارک چاپ ثابت، یا redaction را اضافه میکند. این روشها همان دروازههای نسخه و سازگاری را مثل زیرنوعهای متناظر حاشیهنویسی دنبال میکنند |
Add3DAnnotation, AddRichMediaAnnotation |
حاشیهنویسیهای رسانهٔ تعاملی PDF 1.7 را اضافه میکند. اینها برای گردشکارهایی در نظر گرفته شدهاند که صراحتاً از محتوای 3D یا چندرسانهایِ جاسازیشده پشتیبانی میکنند و برای خروجی بایگانی PDF/A مناسب نیستند |
AddPopupAnnotation |
یک حاشیهنویسی popup را مستقیماً ایجاد میکند. وقتی popup باید به حاشیهنویسی دیگری پیوست شود، AddPopupAnnotationFor را ترجیح دهید |
افزونههای کنش دکمه
| روش |
توضیح |
AddPushButtonWithHideAction |
یک دکمهٔ فشاری ایجاد میکند که کنشش یک یا چند فیلد فرم را پنهان یا آشکار میکند. وقتی فرم به بخشهای اختیاری بدون اجرای JavaScript نیاز دارد، این روش مفید است |
AddPushButtonWithSubmitAction |
یک دکمهٔ ارسال با THPDFSubmitFormFlags صریح ایجاد میکند تا فراخواننده FDF، HTML، XFDF، PDF، GET/POST و گزینههای مرتبط را کنترل کند |
AddPushButtonWithRenditionAction |
یک دکمهٔ فشاری ایجاد میکند که یک کنش Rendition متصل به یک Screen annotation و یک فایل رسانهای را کنترل میکند. حالتهای سازگاری PDF/A و PDF/X کنشهای چندرسانهای را رد میکنند |
AddPushButtonWithSoundAction |
یک دکمهٔ فشاری ایجاد میکند که یک /Sound جاسازیشدهٔ PDF را پخش میکند. بارگذاریها یا نام فایل یا بایتهای خام صوتیِ دادهشده توسط فراخواننده را همراه با THPDFSoundParams میپذیرند |
AddPushButtonWithMovieAction |
یک دکمهٔ کنش Movie قدیمی ایجاد میکند که به واژهنامهٔ بازگرداندهشده توسط AddMovieAnnotation ارجاع میدهد |
کادرهای صفحه و کنترلهای نمایش
| روش یا ویژگی |
توضیح |
SetCropBox, SetBleedBox, SetTrimBox, SetArtBox |
کادرهای اختیاری صفحهٔ تولیدی تعریفشده توسط ISO 32000-1 §14.11.2 را متصل میکند. MediaBox همچنان اندازهٔ فیزیکی کاغذ را دنبال میکند؛ کادرهای unset از زنجیرهٔ پیشفرض استاندارد PDF عبور میکنند |
SetPageRotation |
ورودی /Rotate صفحه را تنظیم میکند. مقادیر به مضارب 90 درجهٔ موردنیاز PDF در بازهٔ 0..359 نرمال میشوند |
SetUserUnit |
/UserUnit PDF 1.6 را برای صفحات بسیار بزرگ تنظیم میکند. پاس دادن 0 ورودی را حذف میکند و صفحه را به مقیاس واحد پیشفرض برمیگرداند |
SetTabsOrder |
ترتیب زبانههای حاشیهنویسی صفحه را از طریق ورودی /Tabs تنظیم میکند. از R، C، S، A یا W مطابق مشخصات PDF استفاده کنید |
DocScale |
مقیاس ترسیم صفحهٔ مورد استفاده در مسیرهای ترسیم سازگاری را تنظیم میکند. آن را روی مقدار پیشفرض بگذارید مگر اینکه فراخواننده عمداً به مختصات قدیمیِ مقیاسدادهشده نیاز داشته باشد |
شفافیت و محتوای اختیاری
| روش |
توضیح |
SetTransparencyGroup, SetTransparencyGroupICC, ClearTransparencyGroup |
یک واژهنامهٔ /Group صفحه را متصل یا حذف میکند تا محتوای دارای alpha بهصورت گروه شفافیت PDF ترکیب شود. نسخهٔ ICC به یک پروفایل ICC ثبتشده در سند ارجاع میدهد |
BeginOptionalContent, EndOptionalContent |
ترسیمهای بعدی صفحه را در یک زنجیرهٔ marked-content محتوای اختیاری PDF 1.5 میپیچد. لایه را ابتدا با THotPDF.RegisterOptionalContentGroup ثبت کنید |
محتوای برچسبدار و فونتهای نوع 3
| روش |
توضیح |
BeginMarkedContentMCIDProps |
یک زنجیرهٔ marked-content را با واژهنامهٔ ویژگیِ درونخطی آغاز میکند که /MCID بههمراه ورودیهای اختیاری /Lang، /Alt، /ActualText و /E را شامل میشود. برای بستن زنجیره از EndMarkedContent استفاده کنید |
SetType3Font |
یک فونت Type 3 ثبتشده از طریق THotPDF.RegisterType3Font را انتخاب میکند تا فراخوانیهای بعدی ShowText متن را با جریانهای glyph تعریفشده توسط فراخواننده صادر کنند |
جایگذاری متن و کمکابزارهای سازگاری
| روش |
توضیح |
SetCharacterSpacing, SetTextMatrix, MoveToNextLine |
عملگرهای سطح پایینِ حالت متن و جایگذاری PDF را برای فراخوانندگانی صادر میکند که به کنترل مستقیم فراتر از TextOut، UnicodeTextOut یا کمکابزارهای text-box نیاز دارند |
SetRGBHyperlinkColor |
رنگ RGB مورد استفاده توسط PrintHyperlink را تنظیم میکند. ویژگی منتشرشدهٔ HyperlinkColor این setter را فراخوانی میکند |
FMEllipse, MFRectangle |
نامهای مستعار ترسیم قدیمی که برای سازگاری با کدهای قدیمی حفظ شدهاند. برای کد جدید، Ellipse و Rectangle را ترجیح دهید |
DirectDrawBarcode |
بارکد را با مختصات مستقیم صفحه و یک نوع عددی بارکد ترسیم میکند. برای کد typed، DrawBarcode را با enum THPDFBarcodeType ترجیح دهید |
TextOutStr, OutText, RtLTextOutStr, SetFontAndSize, ShowMetafileEx |
نامهای مستعار سازگاری یا نقاط ورود ویژهٔ C++Builder که برای کد موجود همچنان در دسترساند. کد جدید معمولاً میتواند از TextOut، RtLTextOut، SetFont و ShowMetafile استفاده کند |
Debug_GetProcessedRtlString, ProcessFont |
کمکابزارهای تشخیصی و سطح پایینِ افشا شده از کلاس هستند. اینجا برای نمایان بودن API مستند شدهاند؛ تولید معمول سند باید از روشهای سطحبالای متن و فونت استفاده کند |
کمکابزارهای فیلد امضای دیجیتال
AttachPAdESSeedValue - یک واژهنامهٔ seed-value PAdES را به یک فیلد امضای موجود متصل میکند تا نمایشگر بتواند پیش از امضا، محدودیتهای digest، subfilter، reason، location، contact، timestamp و certificate را اعلام کند. ابتدا فیلد را با AddPAdESSignatureField یا یک کمکابزار دیگر فیلد امضا ایجاد کنید، سپس AttachPAdESSeedValue را با نام فیلد و تنظیمات THPDFPAdESSeedValue فراخوانی کنید
همچنین ببینید
|