وثائق Real

الصيغة

openfilesdialog(options?: DialogOptions): table | nil

الوسائط

الاسم	النوع	الوصف
`options?`	`DialogOptions`	جدول الإعدادات الاختياري الذي يتحكم في كيفية تصرف العملية.

القيم الراجعة

الاسم	النوع	الوصف
`files`	`table \| nil`	جدول صفيف للبيانات التعريفية للملف المحدد، أو لا شيء عند الإلغاء.

الوصف

يفتح منتقي الملفات الأصلي الذي يمكنه إرجاع عدة ملفات محددة.

استدعه مع 1 parameter: options. يوضح جدول arguments القيم المطلوبة والقيم التي تضبط السلوك.

يعيد files (table | nil). استخدم جدول returns للفصل بين قيم النجاح ونتائج nil والأخطاء القابلة للمعالجة.

مثال

اسمح للمستخدم بتحديد ملفات متعددة باستخدام مرشح الامتداد.

local files = openfilesdialog({
    title = "Choose source files",
    defaultPath = "workspace",
    extensionFilter = { "lua", "luau", "txt" },
})

if files then
    for _, file in ipairs(files) do
        print(file)
    end
end

الأنواع

DialogOptions

تكوين مربع حوار اختيار الملف أو المجلد الأصلي.

title? string يضبط عنوان نافذة الحوار.defaultPath? string يحدد الدليل الذي يظهر عند فتح مربع الحوار.extensionFilter? {string} يحد الملفات القابلة للتحديد من الامتدادات المدرجة، مع أو بدون نقطة بادئة.suggestedName? string يوفر اسم الملف الأولي في مربعات حوار الحفظ.defaultExtension? string يضبط الامتداد المستخدم عندما لا يكون اسم الملف الذي تم إدخاله خاليًا.