File 檔案選擇器

此元件在介面上顯示檔案選擇區域，可顯示檔案類型圖示、檔名稱與檔案修改時間，點選可選擇新檔案。通常用於選擇資料檔案，提供路徑給服務腳本使用。

鍵	類型	描述	必選	預設值	最低版本需求
initialPath	字串	檔案選擇初始頂層目錄	-	XPP 根路徑	-
allowedExtensions	包含字串的陣列	允許的檔案副檔名清單	-	[]	-
label	字串	未選擇檔案時的提示標題	可本地化	""	1.2-10
footerText	字串	未選擇檔案時的提示資訊	可本地化	""	1.2-10
isFile	布林型	是否選擇檔案，如果為 false 則選擇目錄	-	true	1.2-10

此元件可以左划會顯示刪除按鈕，輕按刪除按鈕可將已存的設定值置空。

initialPath 是相對於 XPP 腳本包的相對路徑。若不填，則為目前腳本包路徑。

allowedExtensions 中包含允許選擇的檔名清單，不符合副檔名要求的項目將不會被顯示，更無法被選擇。

返回類型	描述
字串	所選檔案完整絕對路徑

主題

主題鍵	類型	描述
labelColor	顏色	檔名顏色
valueColor	顏色	檔案描述顏色

範例

{
    cell = "File";
    key = "file1";
    initialPath = "scripts";
    isFile = true;  -- 選擇文件
    label = "请选择一个脚本";  -- 標題
    -- footerText = "可选择所有 XXT 支持的脚本格式";  -- 描述  
    allowedExtensions = { "lua"; "xxt"; "xpp" };  -- 只允許選擇這些擴展名的文件
};