====== TOpenDialog — Datei öffnen ======

Der Dialog zum **Öffnen** einer vorhandenen Datei. Er unterscheidet sich von [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] nur durch die Vorgaben: ''Mode'' steht auf ''FD_OPEN'' und ''OverwritePrompt'' ist ''false'' — beim Öffnen gibt es nichts zu überschreiben.

Unit: ''vega.filedlg'' · Basis: [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]]

→ [[lyx_-_programmiersprache:vega:controls|Alle Steuerelemente]] · [[lyx_-_programmiersprache:vega:klassenbaum|Klassenbaum]] · [[lyx_-_programmiersprache:vega:guides:komponenten|Guide: Komponenten]]

----

===== Vererbung =====

**Kette:** [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] → **TOpenDialog**

**Direkte Nachfahren:** keine — diese Klasse wird nicht weiter abgeleitet.

**Quelle:** ''vega/filedlg.lyx''

----

===== Verwendung =====

<code lyx>
var dlg: TOpenDialog := new TOpenDialog();
dlg.SetTitle("Datei oeffnen");
if (dlg.Execute(app)) {
    var voll: TTextBuffer := new TTextBuffer();
    dlg.FullPath(voll);
    // ... damit weiterarbeiten ...
    voll.Destroy();
}
dlg.Destroy();
</code>

Die vollständige Beschreibung der Eigenschaften und des Ablaufs steht bei [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] — diese Klasse setzt nur andere Vorgaben.

----

===== Besonderheiten =====

  * **Vorgaben:** ''Mode = FD_OPEN'', ''OverwritePrompt = false'', ''Filter = %%"*"%%''.
  * Alles Weitere — Filter, Startverzeichnis, Ergebnis — steht bei [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]].

----

===== Eigenschaften =====

Alle Eigenschaften, auch die geerbten.

^ Name ^ Typ ^ Bedeutung ^ Herkunft ^
| ''DefaultExt'' | [[lyx_-_programmiersprache:vega:controls:ttextbuffer|TTextBuffer]] | Wird angehängt, wenn der Name keine Endung hat. Mit führendem Punkt | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |
| ''FileName'' | [[lyx_-_programmiersprache:vega:controls:ttextbuffer|TTextBuffer]] | Vor dem Aufruf der Vorschlag, danach das Ergebnis | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |
| ''Filter'' | [[lyx_-_programmiersprache:vega:controls:ttextbuffer|TTextBuffer]] | Muster wie in Delphi, mehrere mit Semikolon: "*.txt;*.md" | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |
| ''InitialDir'' | [[lyx_-_programmiersprache:vega:controls:ttextbuffer|TTextBuffer]] | Startverzeichnis. Leer heißt: das aktuelle Arbeitsverzeichnis | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |
| ''Mode'' | [[lyx_-_programmiersprache:sprache:datentypen#1_ganzzahl-typen_signiert|int64]] | Betriebsart des Dialogs (''FD_OPEN'', ''FD_SAVE'', ''FD_DIR'') | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |
| ''OverwritePrompt'' | [[lyx_-_programmiersprache:sprache:datentypen#5_wahrheitswerte_bool|bool]] | Beim Sichern nachfragen, wenn die Datei schon da ist | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |
| ''Title'' | [[lyx_-_programmiersprache:vega:controls:ttextbuffer|TTextBuffer]] | Titelzeile des Dialogs | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |

----

===== 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 | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |
| ''Confirm(app: TApplication): void'' | Der Bestaetigen-Weg, gemeinsam für Knopf und Eingabetaste | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |
| ''Create(mode: int64): void'' | Anlegen; ''new TOpenDialog()'' | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |
| ''CurrentDir(): pchar'' | Verzeichnis, in dem der Dialog gerade steht | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |
| ''Destroy(): void'' | Gibt eigene Ressourcen frei | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |
| ''Directory(): pchar'' | Das gewaehlte Verzeichnis. Im Verzeichnismodus dasselbe wie FileName, sonst das Verzeichnis, in dem die gewaehlte Datei liegt | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |
| ''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 | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |
| ''FullPath(dst: TTextBuffer): void'' | Der vollständige Pfad des Ergebnisses | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |
| ''GoUp(): void'' | Eine Ebene nach oben | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |
| ''Navigate(path: pchar): void'' | Wechselt in das Verzeichnis ''path'' | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |
| ''Refill(): void'' | Die Liste neu aus dem Dateisystem fuellen | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |
| ''SetDefaultExt(s: pchar): void'' | Setzt ''DefaultExt'' | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |
| ''SetFileName(s: pchar): void'' | Setzt ''FileName'' | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |
| ''SetFilter(s: pchar): void'' | Setzt ''Filter'' | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |
| ''SetInitialDir(s: pchar): void'' | Setzt ''InitialDir'' | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |
| ''SetTitle(s: pchar): void'' | Setzt ''Title'' | [[lyx_-_programmiersprache:vega:controls:tfiledialog|TFileDialog]] |
| ''Create(): void'' | Anlegen; ''new TOpenDialog()'' | eigen |

----

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