THotPDF.CopyLoadedSourceToStream
Kopierer de originale indlæste PDF-bytes med en kildepositionsbevarende afgrænset læsning
Declaration
procedure CopyLoadedSourceToStream(Destination: TStream;
MaxBytes: Int64; Checkpoint: TNotifyEvent = nil);
Adfærd
Denne HPDFDoc-metode kopierer de tilbageholdte originale kilde-bytes uden at gemme eller normalisere den aktuelle objektgraf og gendanner den lånte kildestream-position ved succes og fejl
Krypterede filindlæsninger bevarer et separat originalt læsehandle, selv efter at adgangskodebaseret dekryptering deaktiverer den almindelige gem-genvej; denne metode kopierer den originale ciphertext, og GetLoadedSourceFileSize rapporterer dens størrelse
Det tilbageholdte originale handle frigøres ved genindlæsning, destruktion og understøttet in-place inkrementel publicering og deltager i fysiske kildefil-alias-tjek
MaxBytes skal være positivt og inkluderer den komplette kildelængde; en større kilde udløser EHPDFIncrementalOutputBudget før den første skrivning
Destination skal være non-nil og må ikke aliasere den indlæste stream eller samme underliggende fil, inklusive et hard link; en utilgængelig original kilde udløser EInvalidOpException
OperationCancellationToken og Checkpoint tjekkes før og under læsninger i blokke på højst 64 KiB; checkpointet modtager THotPDF-instansen
Metoden skriver ved destinationens aktuelle position uden at rydde dens eksisterende indhold; cancellation, læsefejl eller destinationsfejl kan efterlade en delvis kopi, så kaldere bør kassere en mislykket kandidat
Metoden serialiserer ikke ventende objektændringer og etablerer ikke, at den indlæste graf stadig matcher den rå kilde