System.Classes.TBufferedFileStream.Seek

• Übergeordnet: TBufferedFileStream

Delphi

function Seek(const Offset: Int64; Origin: TSeekOrigin): Int64; override;

C++

virtual __int64 __fastcall Seek(const __int64 Offset, TSeekOrigin Origin)/* overload */;
inline int __fastcall  Seek(int Offset, System::Word Origin){ return TStream::Seek(Offset, Origin); }

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	System.Classes.pas System.Classes.hpp	System.Classes	TBufferedFileStream

Beschreibung

Setzt die aktuelle Position im Handle-Stream auf einen neuen Wert.

System.Classes.TBufferedFileStream.Seek erbt von System.Classes.THandleStream.Seek. Der folgende Inhalt bezieht sich auf System.Classes.THandleStream.Seek.

Setzt die aktuelle Position im Handle-Stream auf einen neuen Wert.

Mit Seek wird die aktuelle Position innerhalb der Datei, die dem Handle-Stream zugeordnet ist, entsprechend dem Wert von Offset angepasst. Seek ermöglicht es einer Anwendung, den Dateizeiger beliebig zu setzen.

Der Parameter Origin gibt an, wie der Parameter Offset interpretiert werden soll. Origin sollte einen der folgenden Werte enthalten:

Wert	Bedeutung
soFromBeginning	Offset wird ausgehend vom Beginn der Ressource ermittelt. Seek bewegt den Dateizeiger zur Position Offset. Offset muss >= 0 sein.
soFromCurrent	Offset bezieht sich auf die aktuelle Position in der Ressource. Seek verschiebt den Dateizeiger nach (Position + Offset).
soFromEnd	Offset wird ausgehend vom Ende der Ressource ermittelt. Offset muss <= 0 sein, um die Anzahl der Bytes vor dem Dateiende anzugeben.

Seek gibt den neuen Wert der Eigenschaft Position zurück, welche die neue aktuelle Position in der Ressource bezeichnet.

Siehe auch

• Position

• Read

• Write