HPDFXFDFImportAnnotations 函式

function HPDFXFDFImportAnnotations(const Access: THPDFXFDFAccess;
  const Destinations: THPDFXFDFDestinationAccess;
  Root: THPDFXFDFNode): Integer; overload;

透過提供的存取 callback 映射註解 XML,回傳建立的註解數量

獨立的目標 callback 把本機頁陣列綁到真實的文件間接頁,並保留具名 Unicode 目標與精確設有上限的十進位座標

原始 overload 保留其簽名並使用空目標記錄;明確頁目標需要 page-count 與 page-object callback

這個低階 callback 映射器自身不提供整份文件 rollback;需要設有上限的準入、經驗證的政策與原子檔案發佈時,請使用 SaveAnnotationsXFDFToFile

目標屬性與限制

標準 stamp 外觀傳輸透過 base64 型別化 XML 保留真實的 Form 串流以及設有上限的無環字型、影像與圖形資源

function HPDFXFDFImportAnnotations(const Access: THPDFXFDFAccess;
  const Destinations: THPDFXFDFDestinationAccess; Root: THPDFXFDFNode;
  MaxAppearanceBytes, MaxAppearanceNodes, MaxAppearanceDepth: Integer;
  MaxAppearanceWorkingBytes: Int64;
  CancellationToken: THPDFCancellationToken): Integer; overload;

各限制為正且累計生效,外觀深度上限 62;舊 overload 提供 16 MiB、100000 個節點、深度 62 與 512 MiB 工作預留

建立的間接串流仍歸提供的圖配接器所有;低階編解碼器不接管呼叫端文件的所有權,也不提供整操作 rollback

配接器在 ANSI 轉換與解碼儲存之前,按含空白的原始 base64 長度預留;RAW HEX 與 ASCII 資料在配置串流位元組陣列之前預留

工作預留對完整匯入保守且累計,與輸出位元組無關;呼叫端自有解析出的 XFDF 樹由呼叫端在這個配接器消費之前先行準入

詞法預檢會在建樹之前預留解碼後的 XML 節點與屬性記錄以及繼承的命名空間作用域陣列;節點數、深度與工作儲存是相互獨立的累計限額

AP 專項預檢在呼叫共用 XML 讀取器之前驗證既有的物件標籤詞彙,保持對非法型別的拒絕,同時不保留無關的 XHTML RawXML 片段