THotPDF.LoadFromStream

THotPDF

Loads an existing PDF file from stream.

Delphi 語法：

function LoadFromStream ( DocStream: TStream ): Integer;

function LoadFromStream ( DocStream: TStream; const Password: AnsiString ): Integer;

function LoadFromStream ( DocStream: TStream; AutoDecrypt: Boolean ): Integer;

C++ 語法：

int __fastcall LoadFromStream ( Classes::TStream* DocStream );

int __fastcall LoadFromStream ( Classes::TStream* DocStream, System::AnsiString Password );

int __fastcall LoadFromStream ( Classes::TStream* DocStream, bool AutoDecrypt );

說明

呼叫 LoadFromStream 從 stream 載入既有 PDF document。LoadFromStream function 會傳回載入檔案中的頁數

支援的 RC4 與 AES Standard 加密 PDF 請使用密碼 overload。HotPDF 會驗證使用者或擁有者密碼,從可尋址 stream 上有界的 trailer、xref、文件 ID 與加密字典範圍還原檔案金鑰,在記憶體中解密已載入的字串與 stream,清除已載入的加密狀態,並讓 SaveLoadedDocument 寫出未加密的副本。不帶密碼載入時,會按權威 xref 偏移量擷取原始加密物件,供後續的 DecryptLoadedDocument 在輸入 stream 釋放後使用確切的二進位 security-handler 值。不支援的 encryption revisions 會擲回例外。有界金鑰還原自 HotPDF v2.489.0 起可用,零重讀延遲解密自 HotPDF v2.490.0 起可用

AutoDecrypt overload 以檢視器的方式開啟文件。AutoDecrypt 為 True 且文件以空的使用者密碼加密（只限制權限的文件就是這樣寫出的）時，會在記憶體中解密，效果與密碼 overload 傳入空密碼完全相同，因此可以擷取、轉譯與匯出其文字；此時 IsEncrypted 為 False，後續的 SaveLoadedDocument 會寫出未加密副本。需要密碼的文件與未加密的文件，都照普通 overload 的方式載入。空密碼能否開啟文件會先從相同的有界範圍判斷，不會載入文件兩次。AutoDecrypt 為 False 時，此 overload 就是普通 overload

匯入既有 PDF objects 時，HotPDF 會先解碼 ISO 32000-1 PDF name #XX escape sequences，再將 name values 儲存在內部。像 /PANTONE#20216#20CVC、/lime#20Green 與 /The_Key_of_F#23_Minor 這類 names，在檔案稍後複製或儲存時會保留其預期 byte values

請參閱： LoadFromFile, DecryptLoadedDocument