وثائق Real

الصيغة

savefiledialog(content: string, options?: DialogOptions): FileSystemItem | nil

الوسائط

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

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

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

الوصف

يفتح مربع حوار الحفظ الأصلي ويكتب المحتوى المقدم عندما يختار المستخدم المسار.

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

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

مثال

اسمح للمستخدم باختيار مكان حفظ المحتوى الذي تم إنشاؤه.

local saved = savefiledialog("Example output", {
    title = "Save output",
    suggestedName = "output.txt",
    defaultExtension = "txt",
})

if saved then
    print(saved)
end

الأنواع

DialogOptions

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

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