<< Gesamtübersicht << Klassenübersicht Details der Klasse Funktionsbeschreibungen

SFileSystem

Unterstützt grundlegende Funktionen im Dateisystem [Mehr ...]

Vererbung

Basisklassen(n)   abgeleitete Klassen
  SFileSystem  

Attribute

 

Operationen

public:

Name Parameter Rückgabewert Beschreibung
copyFile const SString& src,
const SString& dest,
BOOL overwrite = FALSE,
BOOL noErrorMsg = FALSE		 BOOL
createDirectory const SString& path,
BOOL noErrorMsg=false		 BOOL Legt ein Verzeichnis an.
createShellLink const SString& path,
const SString& target,
const SString& description="",
const SString& workDir="",
const SString& iconPath="",
int iconID=0		 BOOL Erzeugt eine Verknüpfung.
deleteFile const SString& fullname,
BOOL noErrorMessage=FALSE		 BOOL
getCurrentDirectory SString Liefert den Pfad des aktuellen Verzeichnisses.
getFileExt const SString& fullPath SString Extrahiert aus einem übergebenen Pfad mit Dateinamen die Dateinamenserweiterung.
getFileName const SString& fullPath SString Extrahiert aus einem übergebenen Pfad mit Dateinamen den Dateinamen.
getFileTitle const SString& fullPath SString Extrahiert aus einem übergebenen Pfad mit Dateinamen den Dateinamen ohne Erweiterung.
getFileVersionString const SString& fullFileName,
SString* pErrorText=NULL		 SString Ermittelt, wenn vorhanden die Versionsnummer einer Datei.
getFullPathName const SString& filename SString Ermittelt eine vollständigen Pfad und Dateinamen. Es wird nicht geprüft, ob die Datei existiert.
getPath const SString& fullPath SString Extrahiert aus einem übergebenen Pfad mit Dateinamen den Pfad.
getTempFileName const SString& prefix3="svl",
int id=0		 SString Stellt den Namen einer neuen Temp-Datei im Temp-Verzeichnis zur Verfügung.
getTempPath SString Gibt das aktuelle temporäre Verzeichnis zurück.
run const SString& prg,
const SString& para="",
const SString& workdir="",
WORD ShowWindow=SW_SHOW,
SString* paErrorText=NULL		 BOOL Startet eine Anwendung in einem neuen Prozess.
runAndWait const SString& prg,
const SString& para="",
const SString& workdir="",
WORD ShowWindow=SW_SHOW,
SString* paErrorText=NULL,
long maxSeconds=120		 BOOL Startet eine Anwendung in einem neuen Prozess und wartet bis zur Beendigung.

Detailbeschreibung SFileSystem

Unterstützt grundlegende Funktionen im Dateisystem


sowie das Ausführen von Programmen.

Funktionsbeschreibungen

static copyFile(const SString& src, const SString& dest, BOOL overwrite = FALSE,BOOL noErrorMsg = FALSE) BOOL

static createDirectory(const SString& path, BOOL noErrorMsg=false) BOOL

Legt ein Verzeichnis an.

Parameter:

path Verzeichnispfad des neuen Ordners
noErrorMessage Fehlermeldung unterdrücken

Rückgabe:

BOOL Anlegen erfolgreich

createShellLink(const SString& path, const SString& target, const SString& description="", const SString& workDir="", const SString& iconPath="", int iconID=0) BOOL

Erzeugt eine Verknüpfung.

Verknüpfungen müssen die Endung ".lnk" als Dateinamen besitzen. Alle angegebenen Verzeichnisse müssen existieren.

Parameter:

path vollständiger Pfad und Dateiname der Verknüpfung (Dateiendung: '.lnk'!)
target vollständiger Pfad der zu verknüpfenden Datei
description Beschreibungstext der Verknüpfung
workDir Arbeitsverzeichnis des verknüpften Programms
iconPath vollständiger Pfad der Icon-Datei
iconID ID des Icons in der angegebenen Datei

Rückgabe:

BOOL Shell-Link wurde erstellt

static deleteFile(const SString& fullname, BOOL noErrorMessage=FALSE) BOOL

static getCurrentDirectory() SString

Liefert den Pfad des aktuellen Verzeichnisses.

Rückgabe:

SString aktuelles Verzeichnis

static getFileExt(const SString& fullPath) SString

Extrahiert aus einem übergebenen Pfad mit Dateinamen die Dateinamenserweiterung.

Rückgabe:

SString Dateinamenserweiterung in Kleinbuchstaben

static getFileName(const SString& fullPath) SString

Extrahiert aus einem übergebenen Pfad mit Dateinamen den Dateinamen.

Rückgabe:

SString Dateiname mit Erweiterung

static getFileTitle(const SString& fullPath) SString

Extrahiert aus einem übergebenen Pfad mit Dateinamen den Dateinamen ohne Erweiterung.

Rückgabe:

SString Dateiname ohne Erweiterung

static getFileVersionString(const SString& fullFileName, SString* pErrorText=NULL) SString

Ermittelt, wenn vorhanden die Versionsnummer einer Datei.

Die Versionsnummer besteht aus 4 Teielen.

Parameter:

fullFileName Dateiname mit Pfad

static getFullPathName(const SString& filename) SString

Ermittelt eine vollständigen Pfad und Dateinamen. Es wird nicht geprüft, ob die Datei existiert.

Parameter:

filename Dateiname relativ

Rückgabe:

SString vollständiger Pfad und Dateiname, wenn ein Fehler auftrat wird ein leerer String zurückgeben.

static getPath(const SString& fullPath) SString

Extrahiert aus einem übergebenen Pfad mit Dateinamen den Pfad.

Rückgabe:

SString Laufwerk und Pfad ohne abschließenden Backslash.

static getTempFileName(const SString& prefix3="svl", int id=0) SString

Stellt den Namen einer neuen Temp-Datei im Temp-Verzeichnis zur Verfügung.

Wird id nicht angegeben oder ist 0 so wird die Datei angelegt.
Form des Dateinamens: preXXXX.TMP.

Parameter:

prefix3 die ersten 3 Zeichen des Dateinamens
id wenn 0 wird automatisch ein freier Wert gebildet und die Datei angelegt, sonst wird nur der Dateiname erzeugt.

Rückgabe:

SString Dateiname (inkl. Pfad); bei Fehler Leer-String

static getTempPath() SString

Gibt das aktuelle temporäre Verzeichnis zurück.

Rückgabe:

SString Pfad des temporären Verzeichnisses mit abschließendem Backslash

static run(const SString& prg, const SString& para="", const SString& workdir="", WORD ShowWindow=SW_SHOW, SString* paErrorText=NULL) BOOL

Startet eine Anwendung in einem neuen Prozess.

Parameter:

prg Programmname (inklusive Pfad falls nötig)
para Kommandozeilenparameter für das Programm
workdir Arbeitsverzeichnis des Programms (=aktuelles Verzeichnis zur Programmlaufzeit)
ShowWindow Sichtbarkeit des Programms, eines von:
  • SW_HIDE versteckt das Fenster.
  • SW_MAXIMIZE maximiert das Fenster.
  • SW_MINIMIZE minimiert das Fenster.
  • SW_RESTORE Fenster wiederherstellen, wenn es minimiert oder maximiert war.
  • SW_SHOW zeigt das Fenster in seiner normalen Größe und Position an.
  • SW_SHOWDEFAULT zeigt das Fenster in seinen Standardeinstellungen.
  • SW_SHOWMAXIMIZED maximiert und aktiviert das Fenster.
  • SW_SHOWMINIMIZED minimiert und aktiviert das Fenster.
  • SW_SHOWMINNOACTIVE zeigt das Fenster minimiert und inaktiv.
  • SW_SHOWNA zeigt das Fenster inaktiv in normaler Größe und Position.
  • SW_SHOWNOACTIVATE zeigt das Fenster inaktiv in normaler Größe und Position inaktiv.
  • SW_SHOWNORMAL zeigt das Fenster in seiner normalen Größe und Position.
  • SW_FORCEMINIMIZE Windows 2000: Minimiert das Fenster, sollte nur bei Thred-Übergreifender Fenstersteuerung benutzt werden.
paErrorText Stringvariable in der Fehlertexte aufgefangen werden

Rückgabe:

BOOL Programm fehlerfrei gestartet.
paErrorText Fehlertext, wenn ein Fehler aufgetreten ist.

static runAndWait(const SString& prg, const SString& para="", const SString& workdir="", WORD ShowWindow=SW_SHOW, SString* paErrorText=NULL, long maxSeconds=120) BOOL

Startet eine Anwendung in einem neuen Prozess und wartet bis zur Beendigung.

Parameter:

prg Programmname (inklusive Pfad falls nötig)
para Kommandozeilenparameter für das Programm
workdir Arbeitsverzeichnis des Programms (=aktuelles Verzeichnis zur Programmlaufzeit)
ShowWindow Sichtbarkeit des Programms, eines von:
  • SW_HIDE versteckt das Fenster.
  • SW_MAXIMIZE maximiert das Fenster.
  • SW_MINIMIZE minimiert das Fenster.
  • SW_RESTORE Fenster wiederherstellen, wenn es minimiert oder maximiert war.
  • SW_SHOW zeigt das Fenster in seiner normalen Größe und Position an.
  • SW_SHOWDEFAULT zeigt das Fenster in seinen Standardeinstellungen.
  • SW_SHOWMAXIMIZED maximiert und aktiviert das Fenster.
  • SW_SHOWMINIMIZED minimiert und aktiviert das Fenster.
  • SW_SHOWMINNOACTIVE zeigt das Fenster minimiert und inaktiv.
  • SW_SHOWNA zeigt das Fenster inaktiv in normaler Größe und Position.
  • SW_SHOWNOACTIVATE zeigt das Fenster inaktiv in normaler Größe und Position inaktiv.
  • SW_SHOWNORMAL zeigt das Fenster in seiner normalen Größe und Position.
  • SW_FORCEMINIMIZE ab Windows 2000: Minimiert das Fenster, sollte nur bei Thred-Übergreifender Fenstersteuerung benutzt werden.
paErrorText Stringvariable in der Fehlertexte aufgefangen werden
maxSeconds maximale Laufzeit des Programms

Rückgabe:

BOOL Programm fehlerfrei ausgeführt.
paErrorText Fehlertext, wenn ein Fehler aufgetreten ist.

<< Gesamtübersicht << Klassenübersicht Details der Klasse Funktionsbeschreibungen