THotPDF.GetLoadedAnnotationInfo Method
读取已加载 PDF 指定页面上某条注释的子类型和位置矩形,方便快速筛选和定位特定注释而无需解析完整字典
الإعلان
function GetLoadedAnnotationInfo(PageIndex, AnnotationIndex: Integer; out ASubtype: AnsiString; out ARect: THPDFRect): boolean;
وحدة
HPDFDoc
参数
| 名称 | 用途 |
|---|---|
PageIndex | 目标页面的零起始索引 |
AnnotationIndex | الفهرس الذي يبدأ من الصفر للتعليق التوضيحي المستهدف في مصفوفة Annots بالصفحة |
ASubtype | 输出参数,接收注释的 Subtype 字符串,如 Text、Link、Widget |
ARect | معلمة الإخراج، تستقبل المستطيل الخاص بموضع التعليق التوضيحي على الصفحة (نظام إحداثيات PDF) |
返回值
若成功读取注释信息则返回 True,索引越界或注释解析失败时返回 False,且输出参数值未定义
使用注意事项
- 调用前应先通过
GetLoadedAnnotationCount获取有效索引范围,避免越界访问 - 返回
False时,ASubtype和ARect的内容不可信,不得使用 - 如需访问注释的完整属性(如颜色、内容文本、动作),应进一步调用
GetLoadedAnnotationDict获取字典对象