THPDFRandomAccessSource.TransferAt Method

以 64 KB 區塊把從 Offset 開始的位元組複製到目的串流,並傳回已傳輸的位元組數

宣告

function TransferAt(Offset, Count: Int64;
  Destination: TStream): Int64; virtual;

HPDFDoc

名稱	用途
`Offset`	開始讀取的零基位元組偏移
`Count`	要傳輸的位元組數,會被鉗制為 `Offset` 之後的剩餘位元組數
`Destination`	接收複製位元組的串流;不得為 nil

實際寫入 Destination 的位元組數;Offset 為負、Count 非正值,或 Offset 已達或超出來源大小時為零

Destination 為 nil 時引發 EArgumentNilException;底層 ReadAt 回報無效區塊數時引發 EStreamError
ReadAt 傳回零位元組時複製迴圈會提前停止,因此不足的來源只傳輸實際存在的內容
衍生來源可覆寫此方法,直接串流快取或網路後備資料,不必經過中繼緩衝區