File – Dateiauswahl

Diese Komponente zeigt einen Dateiauswahlbereich mit Dateitypsymbol, Dateiname und Änderungszeit an; durch Tippen kann eine neue Datei ausgewählt werden. Sie wird normalerweise zur Auswahl einer Datendatei verwendet, deren Pfad einem Dienstskript bereitgestellt wird.

Schlüssel	Typ	Beschreibung	Erforderlich	Standardwert	Minimale Version
initialPath	Zeichenfolge	Anfängliches Stammverzeichnis der Dateiauswahl	-	XPP-Stammpfad	-
allowedExtensions	Array von Zeichenfolgen	Liste zulässiger Dateierweiterungen	-	`[]`	-
label	Zeichenfolge	Hinweistitel, wenn keine Datei ausgewählt ist	Lokalisierbar	`""`	1.2-10
footerText	Zeichenfolge	Hinweistext, wenn keine Datei ausgewählt ist	Lokalisierbar	`""`	1.2-10
isFile	Boolescher Wert	Ob eine Datei ausgewählt wird; bei `false` wird ein Verzeichnis ausgewählt	-	`true`	1.2-10

Durch Wischen nach links zeigt diese Komponente eine Löschen-Schaltfläche an; ein Tippen darauf leert den gespeicherten Konfigurationswert.

initialPath ist ein relativer Pfad zum XPP-Skriptpaket. Wenn er nicht angegeben wird, wird der Pfad des aktuellen Skriptpakets verwendet.

allowedExtensions enthält die Liste der zulässigen Dateinamenerweiterungen. Einträge, die die Erweiterungsanforderung nicht erfüllen, werden weder angezeigt noch können sie ausgewählt werden.

Rückgabetyp	Beschreibung
Zeichenfolge	Vollständiger absoluter Pfad der ausgewählten Datei

Theme

Theme-Schlüssel	Typ	Beschreibung
labelColor	Farbe	Farbe des Dateinamens
valueColor	Farbe	Farbe der Dateibeschreibung

Beispiel

{
    cell = "File";
    key = "file1";
    initialPath = "scripts";
    isFile = true;  -- Datei auswählen
    label = "请选择一个脚本";  -- Titel
    -- footerText = "可选择所有 XXT 支持的脚本格式";  -- Beschreibung  
    allowedExtensions = { "lua"; "xxt"; "xpp" };  -- Nur Dateien mit diesen Erweiterungen zulassen
};

Theme

Beispiel​

Beispiel