System.SysUtils.TSearchRec
Delphi
TSearchRec = record
C++
struct DECLSPEC_DRECORD TSearchRec
{
private:
System::TDateTime __fastcall GetCreationTime();
System::TDateTime __fastcall GetLastAccessTime();
System::TDateTime __fastcall GetTimeStamp();
public:
int Time _DEPRECATED_ATTRIBUTE0 ;
__int64 Size;
int Attr;
TFileName Name;
int ExcludeAttr;
Winapi::Windows::THandle FindHandle;
Winapi::Windows::TWin32FindData FindData;
__property System::TDateTime CreationTime = {read=GetCreationTime};
__property System::TDateTime LastAccessTime = {read=GetLastAccessTime};
__property System::TDateTime TimeStamp = {read=GetTimeStamp};
};
Inhaltsverzeichnis
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
record struct |
public | System.SysUtils.pas System.SysUtils.hpp |
System.SysUtils | System.SysUtils |
Beschreibung
TSearchRec definiert die zu suchenden Dateiinformationen für FindFirst und FindNext.
TSearchRec definiert die Dateiinformationen für die Suche mit den Funktionen FindFirst und FindNext. Wird eine Datei gefunden, werden die Felder des TSearchRec-Parameters modifiziert, um die gefundene Datei zu bestimmen.
Attr gibt die Dateiattribute der Datei an. Mit den folgenden Attributkonstanten kann getestet werden, welche Attribute für eine Datei gesetzt sind.
Anmerkung: Die Attributkonstanten werden direkt den DOS-Dateiattribute umgewandelt.
| Konstante | Wert | Beschreibung |
|---|---|---|
|
faReadOnly |
1 |
Schreibgeschützte Datei |
|
faHidden |
2 |
Verborgene Datei |
|
faSysFile |
4 |
Systemdatei |
|
faVolumeID |
8 |
Laufwerks-ID |
|
faDirectory |
16 |
Verzeichnis |
|
faArchive |
32 |
Archivdatei |
|
faSymLink |
64 |
Symbolische Verknüpfung |
|
faAnyFile |
71 |
Beliebige Datei |
Die Konstante faReadOnly hat denselben Namen wie der im Typ TFieldAttribute definierte Aufzählungswert. Wenn sowohl die Unit System.SysUtils und als auch die Unit Data.DB in die Quelldatei einbezogen sind, müssen Sie Zweideutigkeiten vermeiden, indem Sie die jeweilige Unit angeben, z.B. SysUtils.faReadOnly (Delphi) oder SysUtils::faReadOnly (C++).
Um ein Attribut zu testen, kombinieren Sie mit Hilfe des and-Operators den Wert des Attr-Feldes mit der Attributkonstante. Besitzt die Datei das betreffende Attribut, ist der zurückgegebene Wert größer als 0. Wurde beispielsweise eine verborgene Datei gesucht, ergibt der folgende Ausdruck True:
(SearchRec.Attr and faHidden) <> 0.
(SearchRec.Attr & faHidden) != 0.
Time enthält den Zeitstempel der Datei. Mit FileDateToDateTime kann dieser Wert in einen TDateTime-Wert konvertiert werden.
Size enthält die Größe in Byte.
Name enthält den Basisdateinamen sowie die Namenserweiterung.
FindHandle enthält ein internes Handle, mit dem der Status des Suchvorgangs protokolliert wird.
FindData (nur Windows) enthält zusätzliche Informationen wie Erstellungszeit, Zeit des letzten Zugriffs und den langen sowie kurzen Dateinamen.
Mode (nur Linux) enthält die Berechtigungsmaske der Datei.
Siehe auch
Codebeispiele