TFileDialog — Grundlage der Dateidialoge

Die gemeinsame Grundlage von TOpenDialog, TSaveDialog und TSelectDirectoryDialog: Verzeichnisliste, Namensfeld, Filter und das modale Zeigen. Unmittelbar benutzt wird sie selten — man nimmt eine der drei Ableitungen, die sich nur in Mode und den Vorgaben unterscheiden.

Unit: vega.filedlg · Basis: keine — eigene Wurzel

→ Alle Steuerelemente · Klassenbaum · Guide: Komponenten

Vererbung

Kette: TFileDialog — eigene Wurzel, kein Vorfahr. Was diese Klasse kann, steht vollständig auf dieser Seite.

Direkte Nachfahren: TOpenDialog · TSaveDialog · TSelectDirectoryDialog

Quelle: vega/filedlg.lyx

Verwendung

Ein Dateidialog wird angelegt, eingestellt und mit Execute gezeigt. Er ist modal: der Aufruf kehrt erst zurück, wenn der Benutzer bestätigt oder abgebrochen hat.

var dlg: TOpenDialog := new TOpenDialog();
dlg.SetFilter("*.txt;*.md;*.lyx");
dlg.SetTitle("Textdatei oeffnen");
dlg.SetInitialDir("/home/andreas");

if (dlg.Execute(app)) {
    var voll: TTextBuffer := new TTextBuffer();
    dlg.FullPath(voll);              // Verzeichnis + Dateiname
    // ... Datei laden ...
    voll.Destroy();
}
dlg.Destroy();

Execute liefert true bei Bestätigung und false bei Abbruch. Das Ergebnis steht danach in FileName (nur der Name) bzw. vollständig über FullPath; das Verzeichnis liefert Directory.

Besonderheiten

Kein Systemdialog. Vega zeichnet den Dialog selbst — dieselbe Entscheidung wie beim Rest der Bibliothek: GTK, Windows und macOS zeigen jeweils einen ganz anderen Dialog, und „überall gleich„ war der Zweck der Übung. Unter LyxOS gäbe es ohnehin keinen, den man bestellen könnte.
Aufbau aus gewöhnlichen Steuerelementen. Der Dialog ist ein TForm mit Pfadzeile, TListView, Namensfeld und Filterauswahl, gezeigt über TApplication.ShowModal. Wer den Aufbau verstehen will, liest _BuildForm in der Quelle.
Bedienung: Doppelklick oder Eingabetaste öffnet ein Verzeichnis bzw. bestätigt eine Datei, .. führt nach oben.
Filter ist ein Muster wie in Delphi, mehrere durch Semikolon getrennt: "*.txt;*.md". Vorgabe ist "*".
DefaultExt wird angehängt, wenn der eingegebene Name keine Endung hat — mit führendem Punkt angeben.
OverwritePrompt fragt beim Sichern nach, wenn die Datei schon existiert. Bei TSaveDialog ist das die Vorgabe, bei den beiden anderen nicht.

Eigenschaften

Alle Eigenschaften, auch die geerbten.

Name	Typ	Bedeutung	Herkunft
`DefaultExt`	TTextBuffer	Wird angehängt, wenn der Name keine Endung hat. Mit führendem Punkt	eigen
`FileName`	TTextBuffer	Vor dem Aufruf der Vorschlag, danach das Ergebnis	eigen
`Filter`	TTextBuffer	Muster wie in Delphi, mehrere mit Semikolon: „.txt;.md“	eigen
`InitialDir`	TTextBuffer	Startverzeichnis. Leer heißt: das aktuelle Arbeitsverzeichnis	eigen
`Mode`	int64	Betriebsart des Dialogs (`FD_OPEN`, `FD_SAVE`, `FD_DIR`)	eigen
`OverwritePrompt`	bool	Beim Sichern nachfragen, wenn die Datei schon da ist	eigen
`Title`	TTextBuffer	Titelzeile des Dialogs	eigen

Methoden

Alle Methoden, auch die geerbten.

Signatur	Zweck	Herkunft
`AcceptSelection(): bool`	Die gewaehlte Zeile übernehmen: Verzeichnis betreten oder Namen ins Feld schreiben. Liefert true, wenn der Dialog fertig ist	eigen
`Confirm(app: TApplication): void`	Der Bestaetigen-Weg, gemeinsam für Knopf und Eingabetaste	eigen
`Create(mode: int64): void`	Anlegen; `new TFileDialog()`	eigen
`CurrentDir(): pchar`	Verzeichnis, in dem der Dialog gerade steht	eigen
`Destroy(): void`	Gibt eigene Ressourcen frei	eigen
`Directory(): pchar`	Das gewaehlte Verzeichnis. Im Verzeichnismodus dasselbe wie FileName, sonst das Verzeichnis, in dem die gewaehlte Datei liegt	eigen
`Execute(app: TApplication): bool`	Zeigt den Dialog und kehrt erst zurück, wenn eine Entscheidung gefallen ist. true = eine Datei wurde gewaehlt, FileName traegt sie	eigen
`FullPath(dst: TTextBuffer): void`	Der vollständige Pfad des Ergebnisses	eigen
`GoUp(): void`	Eine Ebene nach oben	eigen
`Navigate(path: pchar): void`	Wechselt in das Verzeichnis `path`	eigen
`Refill(): void`	Die Liste neu aus dem Dateisystem fuellen	eigen
`SetDefaultExt(s: pchar): void`	Setzt `DefaultExt`	eigen
`SetFileName(s: pchar): void`	Setzt `FileName`	eigen
`SetFilter(s: pchar): void`	Setzt `Filter`	eigen
`SetInitialDir(s: pchar): void`	Setzt `InitialDir`	eigen
`SetTitle(s: pchar): void`	Setzt `Title`	eigen

Letzte Aktualisierung: 2026-09-05 — Seite neu angelegt; erhoben aus vega/filedlg.lyx im Repo lyx-vcl.