وثائق Real

الصيغة

openfiledialog(options?: DialogOptions): FileSystemItem | nil

الوسائط

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

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

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

الوصف

يفتح منتقي الملفات الأصلي ويعيد البيانات التعريفية للملف المحدد.

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

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

مثال

افتح منتقي الملفات باستخدام مرشح العنوان والامتداد.

local file = openfiledialog({
    title = "Choose a configuration",
    defaultPath = "workspace",
    extensionFilter = { "json", "txt" },
})

if file then
    print(file)
end

الأنواع

DialogOptions

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

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