THotPDF.NewLoadedAnnotation Method
إنشاء قاموس تعليقات توضيحية جديد لنوع فرعي محدد في الصفحة المحددة من مستند PDF المُحمّل، ومناسب لإلحاق أنواع مختلفة من التعليقات التوضيحية مثل التمييزات والروابط والتعليقات النصية وغيرها إلى ملف PDF موجود
الإعلان
function NewLoadedAnnotation(PageIndex: Integer; const ASubtype: AnsiString; ARect: THPDFRect): THPDFDictionaryObject;
وحدة
HPDFDoc
参数
| 名称 | 用途 |
|---|---|
PageIndex | 目标页面的零起始索引,指定注释所在页面 |
ASubtype | 注释子类型名称,如 Text、Link、Highlight,对应 PDF 规范中的 Subtype 键值 |
ARect | موقع وحجم مستطيل التعليق التوضيحي على الصفحة، باستخدام نظام إحداثيات PDF (نقطة الأصل موجودة في الزاوية اليسرى السفلية للصفحة) |
返回值
返回代表新建注释的 THPDFDictionaryObject,可进一步写入颜色、内容文本、动作等附加属性
使用注意事项
ASubtype必须符合 PDF 规范中定义的有效注释子类型字符串,无效子类型可能导致阅读器忽略该注释- 新建注释会被自动注册到目标页面的 Annots 数组,无需手动将其追加到页面字典
- 保存文档前若修改返回的字典对象,必须使用文档内部的修改机制,不得在文档关闭后持有该引用