نظام الملفات

openfolderdialog

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

الصيغة

openfolderdialog(options?: DialogOptions): FileSystemItem | nil

الوسائط

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

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

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

الوصف

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

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

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

مثال

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

local folder = openfolderdialog({
    title = "Choose a workspace folder",
    defaultPath = "workspace",
})

if folder then
    print(folder)
end

الأنواع

DialogOptions

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

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