SFileDialog

Verwaltet den Standard-Dateidialog des Betriebssystems. [Mehr ...]

Vererbung

Basisklassen(n)

abgeleitete Klassen

SFileDialog

Attribute

public:

Attribut	Typ	Beschreibung
inDefaultExtention	SString	Dateierweiterung die automatisch verwendet werden soll, wenn der Nutzer keine Dateierweiterung angibt. Es werden nur 3 Zeichen akzeptiert, ohne Punkt.
inFilename	SString	Vorbelegung der auszuwählenden Datei. Vollständiger Pfad und Dateiname. Der Name darf nur gültige Zeichen beinhalten, sonst wird der Dialog (ohne Fehlermeldung) nicht angezeigt.
inFilter	SString	Enthält den anzuzeigenden Filter. Er muss vor openFile() oder saveFile() gesetzt werden. Der String enthält Paare von Teilstrings wovon der Erste der Filtername und der Zweite die Dateimaske(n) ist. Die Teilstrings werden mit dem senkrechten Strich "\|" und Dateimasken mit Semikolon getrennt. Beispiele: "Textdateien\|.doc;.wri;.txt" oder "Bilder\|.bmp;.gif;.jpg\|Filme\|.avi;.mov"
inFilterIndex	int	Legt den anfänglich ausgewählten Filter fest, beginnend mit 1.
outFileExtention	SString	Dateierweiterung der gewählten Datei.
outFilename	SString	Dateiname der gewählten Datei mit Erweiterung.
outFileTitel	SString	Dateiname ohne Erweiterung
outFullname	SString	Vollständiger Pfad und Dateiname bei erfolgreicher Auswahl.
saveFolderId	SString	Legt die ID fest unter der der lzuletzt verwendete Ordner geseichert wird.

protected:

Attribut	Typ	Beschreibung
memfilter	SMem	Reservierter Speicher für den/die Dateifilter
memname	SMem	Reservierter Speicher für den/die Dateinamen
ofn	OPENFILENAME	Windows-API.Struktur für den Datei-Dialog.

Operationen

public:

Name	Parameter	Rückgabewert	Beschreibung
openFile	HWND hwndParent, const SString& titel="Datei öffnen"	BOOL	Öffnet eine Datei mit Hilfe des File-Dialoges.
openFile	SWindow* pParentWnd, const SString& titel="Datei öffnen"	BOOL	Öffnet eine Datei mit Hilfe des File-Dialoges.
saveFile	HWND hwndParent, const SString& titel="Datei speichern"	BOOL	Speichert eine Datei mit Hilfe des File-Dialoges.
saveFile	SWindow* pParentWnd, const SString& titel="Datei speichern"	BOOL	Speichert eine Datei mit Hilfe des File-Dialoges.

protected:

Name	Parameter	Rückgabewert	Beschreibung
fillOutputVars		BOOL	Speichert die Ergebnisse des Öffnen-/Schließen-Dialoges in den Membervariablen.
prepare_ofn	HWND hwndParent	void	Bereitet die Windows-API-Struktur des Dateidialoges (ofn) für das Anzeigen eines Dialoges vor.

Detailbeschreibung SFileDialog

Verwaltet den Standard-Dateidialog des Betriebssystems.

Beispiel:

SFileDialog dlg;
dlg.inFilename="C:\\Bilder\\logo.bmp";
dlg.inFilter="Bilder|*.bmp;*.gif;*.jpg|Filme|*.avi;*.mov";
BOOL ok=dlg.openFile(this,"Datei suchen");
SString fname=dlg.outFullname;

Funktionsbeschreibungen

fillOutputVars() BOOL

Speichert die Ergebnisse des Öffnen-/Schließen-Dialoges in den Membervariablen.

Diese Funktion wird automatisch nach dem Schließen des Dialoges ausgeführt.

openFile(HWND hwndParent, const SString& titel="Datei öffnen") BOOL

Öffnet eine Datei mit Hilfe des File-Dialoges.

Parameter:

hwndParent	Fenster-Handle des Elternfensters
titel	Titeltext des Dialoges

Rückgabe:

BOOL	Datei erfolgreich geöffnet

openFile(SWindow* pParentWnd, const SString& titel="Datei öffnen") BOOL

Öffnet eine Datei mit Hilfe des File-Dialoges.

Parameter:

hwndParent	Elternfenster
titel	Titeltext des Dialoges

Rückgabe:

BOOL	Datei erfolgreich geöffnet

prepare_ofn(HWND hwndParent) void

Bereitet die Windows-API-Struktur des Dateidialoges (ofn) für das Anzeigen eines Dialoges vor.

Parameter:

hwndParent

Fenster-Handle des Elternfensters

saveFile(HWND hwndParent, const SString& titel="Datei speichern") BOOL

Speichert eine Datei mit Hilfe des File-Dialoges.

Parameter:

hwndParent	Fenster-Handle des Elternfensters
titel	Titeltext des Dialoges

Rückgabe:

BOOL	Datei erfolgreich gespeichert

saveFile(SWindow* pParentWnd, const SString& titel="Datei speichern") BOOL

Speichert eine Datei mit Hilfe des File-Dialoges.

Parameter:

pParentWnd	Elternfenster
titel	Titeltext des Dialoges

Rückgabe:

BOOL	Datei erfolgreich gespeichert

<< Gesamtübersicht

<< Klassenübersicht

Details der Klasse

Funktionsbeschreibungen