System.Classes.THandleStream.Seek

• Übergeordnet: THandleStream

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); }
inline __int64 __fastcall  Seek(const __int64 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	THandleStream

Beschreibung

Setzt die aktuelle Position des Handle-Streams zurück.

Verwenden Sie Seek, um die aktuelle Position in der mit dem Handle-Stream verknüpften Ressource um den angegebenen Versatz (Offset) zu verschieben. Mit Seek kann eine Anwendung an einer bestimmten Position innerhalb der Ressource Lese- oder Schreibvorgänge durchführen.

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 verschiebt die Position zu Offset. Offset muss >= 0 sein.
soFromCurrent	Offset wird ausgehend von der aktuellen Position in der Ressource ermittelt. Seek verschiebt an die Position "Position + Offset".
soFromEnd	Offset wird ausgehend vom Ende der Ressource ermittelt. Offset muss <= 0 sein, um die Anzahl der Byte vor dem Dateiende anzugeben.

Oder Sie können TSeekOrigin und die zugehörigen Werte verwenden, um anzugeben, wo ein Suchvorgang begonnen werden soll.

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

Siehe auch

• TSeekOrigin

• Position

• Read

• Write