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" };  -- これらの拡張子を持つファイルのみ選択可能
};