dropfiles

إسقاط مكونات الملفات

محتويات

• وصف
• تثبيت
• البرامج التجريبية
• تحديث السجل
• ترخيص وإخلاء المسئولية
• الحشرات وطلبات الميزات
• عن المؤلف

وصف

يتم توفير ثلاثة مكونات تدعم السحب والإفلات من Windows Explorer إلى جانب مكونات فرعية يمكنها تصفية الملفات المسقطة. المكونات هي:

• TPJDropFiles - تحكم الحاويات الذي يمسك الملفات التي تم سحبها وإسقاطها على منطقة عميلها أو منطقة عميل عناصر التحكم في الأطفال.
• TPFormDropFiles - المكون غير المرئي الذي يمسك الملفات التي تم سحبها وإسقاطها من Explorer إلى النموذج الذي يحتوي على المكون.
• TPJCTRLDROPFILES - المكون غير المرئي الذي يمسك الملفات التي تم سحبها وإسقاطها من المستكشف إلى عنصر تحكم مرتبط.
• TPJextFileFilter - مكون مرشح الملف الذي يقوم بتصفية الملفات وفقًا لتمديدها.
• TPJWILDCARDFILEFILTER - مكون مرشح الملف الذي يقوم بتصفية الملفات وفقًا لبطاقة برية على غرار DOS.
• TPJfileFilter - فئة قاعدة مجردة لمكونات مرشح الملف.

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

الميزات الرئيسية لمكونات ملفات إسقاط هي:

• يتم تشغيل حدث OnDropFiles عند إسقاط الملفات.
• يتم توفير أسماء الملفات المسقط من خلال خاصية صفيف الملفات . للراحة ، يتم تخزين اسم الملف الأول أيضًا في خاصية اسم الملف .
• يمكن تكوين قائمة الملفات التي تم إسقاطها لتضمين الملفات فقط ، فقط المجلدات أو جميع الملفات والمجلدات.
• يمكن تراجع المجلدات التي تم إسقاطها بحيث يتم سرد جميع الملفات والمرحلين الفرعيين في كل من المجلدات التي تم إسقاطها.
• يمكن تطبيق المرشحات على الملفات والمجلدات التي تم إسقاطها. يتم ذلك بإحدى طريقتين:
  • من خلال التعامل مع حدث OnFileFilter وتحديد الملفات والمجلدات التي يجب المرور عبر المرشح.
  • عن طريق ربط مكون ملف الإسقاط بمكون مرشح ملف خاص ، مشتق من TPJfileFilter التجريدي. في هذه الحالة ، يتم تصفية الملفات المسقط تلقائيًا بواسطة مكون المرشح. يتم توفير مكونين للمرشح: TPJextFileFilter الذي يترشح وفقًا لتمديدات الملف و TPJWILDCARDFILEFILTER التي تستخدم البطاقات البرية على غرار DOS. يمكن للمطورين إنشاء مكونات مرشح إضافية عن طريق الاستخلاص من TPJfileFilter .
• يمكن استرداد تحسس الماوس حيث تم إسقاط الملفات ، كما يمكن الإشارة إلى أي عنصر تحكم تحت مؤشر الماوس في ذلك الوقت.
• يمكن استخدام حدث OnBeforedRop للقيام بالمعالجة المسبقة قبل إسقاط الملفات بالفعل.
• تُعلم خاصية مجموعة ISFolder ما إذا كان عنصر مكافئ في خاصية الملفات عبارة عن ملف أو مجلد.
• يمكن إحضار نافذة الامتلاك إلى المقدمة عند إسقاط الملفات.

التوافق

تم اختبار المكونات على مجمعات Windows من Delphi 7 إلى Xe4 (باستثناء Delphi 2005) و Delphi Xe2 إلى Xe4 64 بت. يُعتقد أن المكونات تجمع على المترجمين إلى Delphi 3 ، لكن هذا غير مضمون.

المكونات مخصصة للاستخدام مع VCL فقط: فهي غير متوافقة مع Firemonkey.

.NET و NONDOWS منصات غير مدعومة.

تثبيت

يتم توفير مكونات ملفات DROP وتوثيقها وبرامج التجريبية في ملف مضغوط. قبل التثبيت ، تحتاج إلى استخراج جميع الملفات من ملف zip ، مع الحفاظ على بنية الدليل. سيتم استخراج الملفات التالية:

• PJDropFiles.pas - رمز مصدر المكون.
• PJDropFiles.dcr - رسومات لوحة مكون.
• PJDropFilesDsgn.pas - محرري العقارات ورمز مصدر تسجيل المكون.
• PJDropFilesDsgn.dfm - نموذج محرر الممتلكات.
• README.md - هذا الملف.
• CHANGELOG.md - سجل تغيير المكون.
• MPL-2.txt ترخيص Mozilla Public V2.0.
• Documentation.URL اختصار للوثائق عبر الإنترنت للمكون.

بالإضافة إلى الملفات المذكورة أعلاه ، ستجد الكود المصدري لمشروعين تجريبيين Demo1 و Demo2 .

يمكنك الآن تثبيت المكونات في Delphi IDE. للقيام بذلك ، يجب إضافة الملفات PJDropFiles.pas و PJDropFiles.dcr و PJDropFilesDsgn.pas و PJDropFilesDsgn.dfm إلى حزمة وقت التصميم. إذا كنت بحاجة إلى مساعدة في القيام بذلك ، انظر هنا.

البرامج التجريبية

يتم تضمين رمز المصدر لبرنامجين تجريبيين في التنزيل:

1. يمارس البرنامج التجريبي الرئيسي جميع مكونات ملفات الإسقاط الثلاثة ومكونات المرشح.
2. برنامج يوضح كيفية استخدام TPJCtrldropfiles مع إطارات.

يتطلب كلا البرامج التجريبية Delphi 7 كحد أدنى. كلاهما متوافق مع مجمعات Windows Delphi 32 بت و 64 بت.

لمزيد من المعلومات حول العروض التوضيحية ، راجع ملف README.md في دليل التجو Demos .

تحديث السجل

يتم توفير سجل تغيير كامل في CHANGELOG.md تم تضمينه في التنزيل.

ترخيص وإخلاء المسئولية

يتم إصدار هذه المكونات بموجب شروط ترخيص Mozilla Public V2.0.

يتم الاعتراف بجميع العلامات التجارية ذات الصلة.

الحشرات وطلبات الميزات

يمكن الإبلاغ عن الأخطاء أو ميزات جديدة مطلوبة عبر متتبع إصدار المشروع. مطلوب حساب github.

يرجى التحقق مما إذا كان قد تم بالفعل إنشاء مشكلة لتقرير أو طلب مماثل. إذا كان الأمر كذلك ، فالرجاء إضافة تعليق يحتوي على أكبر قدر ممكن من المعلومات في المشكلة الحالية ، أو إذا لم يكن لديك شيء لإضافته ، فقط أضف A؟ ( :+1: التعليق. إذا لم تكن هناك مشكلة قائمة مناسبة ، فيرجى إضافة مشكلة جديدة وإعطاء أكبر قدر ممكن من المعلومات.

عن المؤلف

أنا بيتر جونسون - مبرمج هواة يعيش في سيريجيون في ويست ويلز ، المملكة المتحدة ، ويكتب بشكل رئيسي في دلفي. تتوفر برامجي ورمز المكتبة الآخر من: https://delphidabbler.com/.

هذا المستند هو حقوق الطبع والنشر © 2005-2022 ، PD Johnson.