تسجيل نوع ملف

Function: RegisterFileType

الغرض
تسجيل (تعريف) نوع ملف في النظام بحيث يمكن إعطاؤه وصفاً و رمزاً، مع إمكانية تحديد البرنامج الذي سيقوم بفتح ذلك الملف (في حالة كونه مستنداً).

الصيغة

function RegisterFileType(TypeExt, AppID, Description, IconFile: string; IconIndex: Integer; Overwrite: Boolean = False; SetOpenCommand: Boolean = False; Command: string = ''; ArabicCaption: Boolean = True): Boolean;

الوسائط (Parameters)

الشرح
تقوم هذه الدالة بتسجيل (تعريف) نوع من الملفات في سجل النظام بحيث يصبح معروفاً للنظام Windows و يمكن إعطاؤه وصفاً و رمزاً يمثله. نوع الملف - كما هو معروف في النظام Windows - يتم تحديده عن طريق امتداد الملف، مثلاً الامتدادا TXT يعني أن الملف هو ملف نصي عادي، و الامتداد DOC يعني أن الملف هو ملف MS Word، و الامتداد BMP يعني أن الملف هو ملف صورة نقطية، ... إلخ.
إذا كان برنامجك يقوم بإنشاء ملفات من نوع خاص به (ذات امتداد خاص) فإنه يمكنك استعمال هذه الدالة لتسجيل ذلك النوع في النظام.
هذه الدالة تسمح لك أيضاً بتحديد البرنامج الذي سيتولى فتح هذا النوع من الملفات (إذا كان النوع الذي تقوم بتسجيله عبارة عن نوع من المستندات التي يتم فتحها بواسطة برنامج تطبيقي).
* الامتداد (TypeExt) الذي يحدد نوع الملف يمكن أن يكون من غير النقطة (مثلاً "rhd") أو مع النقطة (مثلاً ".rhd").
* البارامتر AppID يمكن أن يكون بالعربية أو الإنجليزية (يستحسن بالإنجليزية) و لكن دون فراغات، مثلاً ReportHeadDesign أو Report.Head.Design أو Report_Head_Design.
* البارامتر Description هو وصف نوع الملف الذي يظهر كجزء من خصائص الملف، و يمكن أن يكون بالعربية أو الإنجليزية.
* البارامتر IconFile يحدد الملف الذي سيؤخذ منه الرمز لتمثيل هذا النوع من الملفات. غالباً ما يشير هذا البارامتر إلى المسار الكامل للملف التنفيذي للتطبيق المسؤول عن فتح هذا النوع من الملفات، و أحياناً يشير إلى ملف رمز (Icon).
* البارامتر IconIndex يشير إلى رقم الرمز ضمن الملف المحدد في البارامتر IconFile. إذا كان الملف المشار إليه هو ملف تنفيذي (EXE) فإن هذا الرقم غالباً ما يكون أكبر من الصفر (لأن الرمز رقم صفر هو رمز التطبيق نفسه).
إذا تركت البارامتر IconFile فارغاً (Empty String) فإن النظام سيستعمل رمزاً افتراضياً. و إذا قمت بتحديد ملف التطبيق المسؤول عن فتح هذا النوع من الملفات (في البارامتر Command) - مع ترك البارامتر IconFile فارغاً - فإن النظام يستعمل رمز صفحة صغيرة و بداخلها رمز التطبييق.
* البارامتر Overwrite يجب استعماله بحذر لأنه قد توجد برامج أخرى تستعمل نفس نوع الملفات، و يمكن أن يؤدي تعديل بيانات السجل إلى عدم ربط النظام تلك الملفات بتلك البرامج.
* البارامتر SetOpenCommand يحدد ما إذا كنت تريد إضافة الأمر فتح (أو Open) إلى قائمة النظام التي تظهر عند النقر على هذا النوع من الملفات بالزر الأيمن للفأرة.
إذا كانت قيمة هذا البارامتر هي True فينبغي تحديد مسار التطبيق المسؤول عن فتح هذا النوع من الملفات في البارامتر Command. إذا أهملت هذا البارامتر (أو كانت قيمته False) فإن الدالة تهمل البارامترين التاليين (Command و ArabicCaption).
* البارامتر Command يحدد المسار الكامل للتطبيق الذي سيتولى فتح هذا النوع من الملفات عند النقر على الأمر فتح (أو Open) في القائمة أو عند النقر المزدوج على الملف.
إذا كانت قيمة هذا البارامتر نصاً فارغاً (Empty String) فإن الدالة لا تقوم بشيء بخصوص إضافة الأمر فتح إلى قائمة النظام.
* البارامتر ArabicCaption يحدد نص الأمر. إذا كانت قيمته True (الافتراضية) فإن نص الأمر سيكون فتح (أي بالعربي)، أما إذا كانت قيمته False فإن نص الأمر سيكون Open (بالإنجليزية).

إذا نجحت الدالة في تسجيل نوع الملف (بصرف النظر عن إضافة الأمر فتح) فإنها تعيد True، و إذا فشلت لأي سبب فإنها تعيد False.

 أعلى الصفحة