THotPDF.OpenLoadedPageContentStream
把已載入頁面的 /Contents 值開啟為呼叫端自有的唯讀邏輯串流
Delphi 宣告
function OpenLoadedPageContentStream(
PageIndex: Integer;
out ContentStream: TStream
): boolean;
C++Builder 宣告
bool __fastcall OpenLoadedPageContentStream(
int PageIndex,
System::Classes::TStream *&ContentStream
);
從零起算的已載入頁面至少有一個有效內容串流時,結果為 true
行為
單一內容串流與 /Contents 陣列共用同一組介面,相鄰片段之間會插入一個換行位元組,避免 token 跨越片段邊界黏合
未過濾的片段保持來源支撐,讀取時不必完整具體化;有過濾的片段則惰性解碼到一個自適應暫存串流,走訪移往他處時釋放前一個已解碼片段
有過濾片段的長度會在需要時才探測,讀取已知前綴不會解碼後面的片段;要求 Size 或從結尾 seek 時,才會解析所有剩餘長度
串流支援隨機讀取與 seek,但拒絕 Write 與 SetSize
所有權
呼叫端必須釋放 ContentStream,且擁有它的 THotPDF 實例與已載入文件的生命週期必須長於傳回的串流
可用 GetLastPageContentSequenceInfo 檢視序列處理量與記憶體保留遙測