ارتباطات ملفات الإضافة

توفر واجهة FileAssociations أنواعًا تمكّن الإضافات من تسجيل وتعديل ومعالجة امتدادات الملفات بمرونة. باستخدام هذه الأنواع، يمكن للمطورين برمجة إضافة لإدارة ارتباط ملف. عند تمكين الإضافة، يتعرف cTrader على الملفات ذات الصلة ويوجهها إلى الإضافة لمعالجتها.

مع تكوين الإضافات للتعامل مع الملفات مباشرة في واجهة مستخدم cTrader، قد لا يضطر المستخدمون بعد الآن إلى التبديل بين تطبيقات متعددة عند العمل مع الملفات. على سبيل المثال، يمكن إنشاء إضافة لفتح وإدارة جميع الملفات المستخدمة مع استراتيجية تداول معينة.

العمليات

تثبيت إضافة

عندما يقوم مستخدم cTrader بتثبيت وتمكين إضافة تدعم نوع ملف معين لأول مرة، يظهر مربع حوار. يُطلب من المستخدم ربط امتداد الملف بالإضافة.

بعد أن يؤكد المستخدم العملية، يقوم جهاز الكمبيوتر الخاص به بتحديث إعدادات ارتباط الملفات على مستوى النظام، ويتم تطبيق التكوين الجديد على الفور.

تصبح الأيقونة الجديدة لنوع الملف مرئية في مستكشف الملفات. إذا لم يتم توفير أيقونة لنوع الملف، يتم استخدام أيقونة الإضافة الافتراضية.

استخدام الإضافة

إذا تم تمكين إضافة تدعم امتدادات الملفات في cTrader، يتم استدعاء الإضافة للعمل مع الملفات عندما يقوم المستخدمون بأي مما يلي:

• سحب وإسقاط الملفات - يمكن للمستخدمين سحب ملف مدعوم وإسقاطه في واجهة مستخدم cTrader.

• فتح الملفات في مستكشف الملفات - يمكن للمستخدمين النقر نقرًا مزدوجًا على ملف لفتحه أو استخدام خيار فتح باستخدام وتحديد cTrader.

  • إذا كان تطبيق cTrader مفتوحًا، تتلقى الإضافة الملف على الفور.
  • إذا كان تطبيق cTrader مغلقًا، يتم تشغيل cTrader أولاً ثم تتلقى الإضافة الملف.

يتم نسخ الملف المستلم إلى مجلد البيانات الخاص بالإضافة ويتم حذفه بمجرد انتهاء الإضافة من معالجته.

المسار إلى مجلد البيانات الخاص بالإضافة: …/Documents/cAlgo/Data/Plugins/{PluginName}/Temp.

في الحالات التي يرتبط فيها امتداد الملف بعدة إضافات ممكّنة، تعالج كل إضافة الملف بشكل مستقل.

عند إزالة ارتباط ملف بسبب تعطيل الإضافة ذات الصلة في نسخة cTrader، تتم إعادة إضافة ارتباط الملف تلقائيًا في نسخة cTrader أخرى حيث يتم تمكين نفس الإضافة.

إجراء تجاوز يدوي

إذا قام المستخدم لاحقًا بتغيير البرنامج الافتراضي لنوع ملف معين ضمن إعدادات الكمبيوتر العادية الخاصة به، يتوقف cTrader تلقائيًا عن التعامل مع نوع الملف هذا.

لتعيين cTrader كبرنامج افتراضي للتعامل مع الملفات بهذا التنسيق مرة أخرى، يجب على المستخدم إعادة إنشاء ارتباط الملف بهذه الطريقة:

1. افتح cTrader وقم بتعطيل الإضافة ذات الصلة.
2. قم بتمكين الإضافة. عندما يظهر مربع الحوار، قم بتأكيد العملية.

هذا الإعداد يساعد الإضافات وتطبيق cTrader على إدارة امتدادات الملفات مع تجنب التداخل مع البرامج الأخرى.

مثال على الإضافة

تقوم الإضافة المثال ببساطة بإضافة ارتباطات الملفات لأنواع الملفات التالية:

• CSV
• PNG
• PDF
• TXT

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

using System;
using cAlgo.API;
using cAlgo.API.Collections;
using cAlgo.API.Indicators;
using cAlgo.API.Internals;

namespace cAlgo.Plugins
{
    [Plugin(AccessRights = AccessRights.None)]
    public class FileAssociationSample : Plugin
    {
        private const string FileExtension1 = ".csv";
        private const string FileExtension2 = ".png";
        private const string FileExtension3 = ".pdf";
        private const string FileExtension4 = ".txt";

        protected override void OnStart()
        {
            AddFileAssociations();
            FileAssociations.FileOpened += FileAssociations_FileOpened;

            Print("File associations have been added.");
        }

        private void AddFileAssociations()
        {
            FileAssociations.Add(FileExtension1);
            FileAssociations.Add(FileExtension2);
            FileAssociations.Add(FileExtension3);
            FileAssociations.Add(FileExtension4);
        }

        private void FileAssociations_FileOpened(FileAssociationsFileOpenedEventArgs obj)
        {
            Print($"File opened: {obj.FilePath}");
        }

        protected override void OnException(Exception exception)
        {
            Print($"Exception: {exception}");
        }
    }
}