高级页面内容 API

PageObjectInfo 返回一个 TPdfPageObjectInfo 快照，包含句柄、对象类型、常规与旋转边界、有效矩阵、活动状态、透明度、填充与描边颜色、alpha 值、描边宽度、线条连接方式、线帽样式、虚线数组和虚线相位

HasRotatedBounds、HasActiveState 和其他 Has* 字段用于区分不可用的原生值与有效的零值

RotatedBounds 携带旋转后的四边形，HasLineJoin 和 HasLineCap 决定连接与端点样式是否有效，DashPhase 偏移虚线图案的起点

UpdatePageObject 把每个选中的字段应用到同一个原生对象，并且只重新生成一次页面内容

TransformPageObject 把一个仿射 FS_MATRIX 与所选对象复合

• PathInfo 返回每个路径段的填充模式、描边状态、段类型、端点和闭合状态
• PageObjectClipPath 返回与页面对象关联的每个剪裁子路径和段
• TransformPageObjectClipPath(Index, Matrix) 只变换该剪裁几何，并保持页面对象矩阵不变
• FormObjectChildren 返回 Form XObject 直接子对象的详细快照
• DetachFormObjectChild(FormIndex, ChildIndex) 移除一个子对象，并把返回的 FPDF_PAGEOBJECT 的所有权转移给调用方，调用方必须插入或销毁它

• PageObjectMarks、PageObjectMarkedContentID、AddPageObjectMark、SharePageObjectMark、SetPageObjectMarkParam、RemovePageObjectMarkParam 和 RemovePageObjectMark 检查、复用和更新标记内容关联，而不会替换无关的属性
• TextObjectGlyphOutline 公开字形路径几何，而 TextObjectGlyphWidth(Index, GlyphIndex, FontSize) 返回所请求尺寸下的原生字形步进宽度
• TextObjectFontSize(Index) 读取原生文本对象尺寸，SetTextObjectFontSize(Index, FontSize) 直接编辑尺寸，无需通过矩阵变换近似
• GetImageObjectRenderedBitmap(Index) 返回一个由调用方持有的位图，其中图像蒙版、颜色转换和图像矩阵已由 PDFium 应用
• AnnotationObjectCount、AnnotationObjectInfo、AddPathToAnnotation 和 RemoveAnnotationObject 操作注释外观对象
• IsAnnotationObjectSubtypeSupported(Subtype) 探测已加载的 PDFium 模块是否支持该子类型的外观对象提取、更新和移除
• PerformNamedAction 分发已知的文档动作，OnNamedAction 报告命名动作回调

CharacterInfo 返回填充与描边颜色、字体名称、PDF 字体标志、宽松字形边界、有效矩阵以及关联的文本对象句柄

CharacterIndexToTextIndex 和 TextIndexToCharacterIndex 在 PDFium 字符索引与生成的文本流索引之间转换

TPdfAnnotation 通过 HasBorder、BorderHorizontalRadius、BorderVerticalRadius 和 BorderWidth 公开边框圆角与宽度

颜色覆盖扩展到 ColorAlpha、InteriorColor 和 InteriorColorAlpha，标记元数据由 HasAuthor、HasName、HasSubject、HasModificationDate、HasCreationDate 和 HasIcon 控制，墨迹手势、四边形几何和链接目标则通过 InkList、HasAttachmentPoints、HasLinkUri 和 LinkUri 公开

常态、悬停和按下外观流通过 HasAppearanceNormal、HasAppearanceRollover 和 HasAppearanceDown 哨兵字段及其对应的 AppearanceNormal、AppearanceRollover 和 AppearanceDown 字符串提供

读取注解时，这些哨兵字段标识的是非空的外观内容：原生 API 对缺失流和空流返回同样的空字符串，因此两者都报告 False，记录写回时也保持原样不动；调用方仍可以把哨兵字段显式设为 True 来写出一个空外观

把更新后的注释记录赋回 Annotation[Index]，即可写入选定的边框或外观值

• ConfigurePdfLibrary、GetPdfLibraryConfiguration 和 PdfLibraryConfigurationSealed 在首次加载之前配置并审计不可变的进程级原生初始化与沙箱策略
• TPdfLibraryConfiguration 携带 UserFontPaths、V8Isolate、V8EmbedderSlot、V8Platform、Renderer、FontBackend、BrotliEnabled、IsolatePerDocument 和 AllowMachineTime，并使用 TPdfRendererPreference（prpDefault、prpAgg、prpSkia）和 TPdfFontBackendPreference（pfbpDefault、pfbpFreeType、pfbpFontations）只选择所请求配置需要的原生字段
• PdfDefaultTtfMapCount 和 TryGetPdfDefaultTtfMapEntry 以带检查的索引访问枚举原生默认字体替换
• TPdfDefaultTtfMapEntry 从一个索引映射条目复制字体名称、字符集和原生平台字体元数据
• FormFieldZOrderAtPoint 和 LinkZOrderAtPoint 返回最前面的原生 z 序，不存在目标时返回 -1
• TryGetAnnotationFileAttachment 在原生注释句柄有效期间复制有界的文件元数据和载荷
• TPdfAnnotationAttachment 独立于页面和注释句柄持有这份复制的元数据与载荷
• GetLinkedAnnotationIndex 和 GetLinkedAnnotationChain 解析 Popup 和 IRT 关系，并带有悬空引用、循环和深度保护
• TPdfAnnotationRelationship 选择 Popup（parPopup）或 IRT（parInReplyTo）关系，TPdfAnnotationSubtypes 存储焦点策略子类型数组
• GetAnnotationDictionaryValue 和 GetAttachmentDictionaryValue 在返回受支持的标量值之前报告确切的原生值类别
• TPdfDictionaryValueKind 保留原生对象类别（pdvkUnknown、pdvkBoolean、pdvkNumber、pdvkString、pdvkName、pdvkArray、pdvkDictionary、pdvkStream、pdvkNull、pdvkReference），TPdfDictionaryValue 在 NumberValue 和 StringValue 中携带受支持的数字或字符串标量，并以 HasScalarValue 作为显式哨兵
• SetFocusableAnnotationSubtypes 和 GetFocusableAnnotationSubtypes 通过原生表单句柄控制键盘焦点资格
• TPdfStructureElement.Attributes 是一棵 TPdfStructureAttributeValues 扁平树，其 TPdfStructureAttributeValue 节点通过 AttributeIndex 关联到所属的属性字典，并在 BlobValue 中保留强类型嵌套值和无损二进制数据
• TPdfView.FormFieldZOrderAt、TPdfView.LinkZOrderAt 和 TPdfView.ReplaceFormTextAndKeepSelection 通过可视控件公开对应的坐标转换和保留选择的表单操作

• ThumbnailRawData 返回滤镜解码之前的内嵌缩略图流
• ThumbnailDecodedData 返回滤镜解码之后的内嵌缩略图流
• TransformPageContent 变换并剪裁所有页面对象、重新生成页面并重载其派生句柄
• TransformPageAnnotations 对当前页面上的所有注释应用相同的仿射坐标模型

RenderPageWithMatrix 接受一个可逆的 FS_MATRIX 和一个设备坐标下的剪裁矩形

接收调用方持有的 TBitmap 的重载直接渲染到兼容的 32 位 DIB 中，只有当无法创建外部 PDFium 位图时才回退为一次复制

矩阵渲染绘制通过渲染标志选择的页面内容和非交互注释，但不会调用表单填充覆盖层渲染器