THPDFFDFAnnotationGraph 類別

單元：HPDFFDFAnnotations

擁有一個有界 FDF 值圖形、其間接物件及其註解陣列

讀取與寫入

Decode(Bytes, Options, AllowFields) 驗證完整的二進位 FDF 資料並回傳呼叫端擁有的圖形；Encode 回傳規範 FDF 位元組，其中串流長度與交叉參照偏移重新產生

AnnotationCount、Annotation、AnnotationPage 與 ObjectCount 檢查已准入的註解圖形；Resolve 沿圖形範圍的間接參照追蹤

選用的 AllowFields 解碼旗標允許 Fields 陣列用於圖形檢查；它不實作欄位填充，也不授權僅註解配接器丟棄欄位更新

建構

用 THPDFFDFOptions 建立圖形，呼叫 StartAnnotations，再用 CreateValue、SetScalar、SetStream、AddItem、AddEntry、Define 與 AppendAnnotation 建構其值

建構器的純量 token 使用 PDF 語法，例如帶斜線前綴的名稱或括號字串；字典項目名稱是解碼後的名稱位元組，不帶前導斜線

每個值都屬於其圖形，容器項目是借用的；不要單獨釋放子值、不要附加來自其他圖形的值，也不要在釋放圖形之後繼續持有值

建構的串流在編碼期間取得其規範 Length；請提供串流位元組，而不是手工建構相符的 Length 項目

Context 與限制

ActionCount、Action、IsLocalGoTo、IsLocalDestination 與 LocalDestinationPage 檢查實際註解 action 脈絡，不執行其中的 action

圖形變更使快取的 action 脈絡失效；後續查詢在相同的工作儲存、深度與取消限制下重建它們

ReservedBytes 回報保守的准入核算，Reserve 允許配接器在配置之前准入額外的圖形相關儲存

畸形參照、重複的解碼字典名稱、無效註解頁面、不可准入的子類型與超限都會在回傳編碼結果之前拋出例外

文件級替換、權限與發佈行為見原生註解 FDF 交換