System.Classes.TStream.Seek
Delphi
function Seek(Offset: Longint; Origin: Word): Longint; overload; virtual;
function Seek(const Offset: Int64; Origin: TSeekOrigin): Int64; overload; virtual;
function Seek(const Offset: Int64; Origin: Word): Int64; overload; deprecated; inline;
C++
virtual int __fastcall Seek(int Offset, System::Word Origin)/* overload */;
virtual __int64 __fastcall Seek(const __int64 Offset, TSeekOrigin Origin)/* overload */;
__int64 __fastcall Seek _DEPRECATED_ATTRIBUTE0 (const __int64 Offset, System::Word Origin)/* overload */;
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | System.Classes.pas System.Classes.hpp |
System.Classes | TStream |
Beschreibung
Steuert eine bestimmte Position in der Stream-Ressource an.
Mit Hilfe von Seek können Sie die aktuelle Position des Streams im jeweiligen Speichermedium (Speicher oder Festplattendatei) verschieben.
Der Parameter Origin gibt an, wie der Parameter Offset interpretiert werden soll. Origin sollte einen der folgenden Werte enthalten:
| Wert | Bedeutung |
|---|---|
|
soBeginning |
Offset wird ausgehend vom Beginn der Ressource ermittelt. Seek bewegt den Dateizeiger zur Position Offset. Offset muss >= 0 sein. |
|
soCurrent |
Offset bezieht sich auf die aktuelle Position in der Ressource. Seek verschiebt den Dateizeiger nach (Position + Offset). |
|
soEnd |
Offset wird ausgehend vom Ende der Ressource ermittelt. Offset muss <= 0 sein, um die Anzahl der Bytes vor dem Dateiende anzugeben. |
Seek liefert den neuen Wert in der Eigenschaft Position zurück.
Seek wird von den Eigenschaften Position und Size aufgerufen.
Anmerkung: In TStream ist die Methode Seek in zwei Versionen (32-Bit- oder 64-Bit-Syntax) implementiert, die sich gegenseitig aufrufen. Abgeleitete Stream-Klassen müssen mindestens eine dieser Versionen überschreiben. Die überschriebene Methode darf dabei nicht die geerbte Standard-Implementierung aufrufen.