طريقة Chartshot

يشرح دليل المستخدم هذا كيفية استخدام طريقة TakeChartshot() عند إنشاء خوارزميات cTrader. إذا كنت متحمسًا للبدء، ما عليك سوى قراءة ملخصنا لمدة دقيقة واحدة أدناه.

استخدام طريقة TakeChartshot()

توفر لقطات Chartshot طريقة لإنشاء لقطات شاشة سريعة للرسوم البيانية للتداول. إذا قمت بإنشاء لقطة Chartshot يدويًا عبر شريط أدوات cTrader، يتم حفظ لقطة الشاشة على جهازك المحلي بالإضافة إلى تحميلها تلقائيًا إلى بوابة خاصة توفر عدة طرق لمشاركتها (على سبيل المثال، عبر كود HTML قابل للتضمين).

بدورها، تتيح واجهة برمجة التطبيقات (API) الخاصة بنا إنشاء لقطات Chartshot تلقائيًا. على عكس لقطات Chartshot العادية، لا يتم حفظ لقطات Chartshot التي تم إنشاؤها بواسطة خوارزميات cTrader في أي مكان بشكل افتراضي. بدلاً من ذلك، يتم إرجاع لقطات Chartshot هذه كمصفوفات بايت يمكنك حفظها حيثما تريد عن طريق تحديد إجراء إضافي في الكود.

تعمل طريقة byte[] TakeChartshot() على النحو التالي:

• byte[] TakeChartshot(). تلتقط لقطة Chartshot للرسم البياني الذي تعمل عليه الخوارزمية وتعيدها كمصفوفة من البايتات.

لاحظ أن الطريقة تعمل فقط إذا كان الرسم البياني مرئيًا. للسماح بالتحقق بسهولة من رؤية الرسم البياني، تتضمن واجهة Chart خاصية IsVisible. وهي تساوي true للرسم البياني المرئي وfalse للرسم البياني غير المرئي.

إنشاء مثال لخوارزمية cBot

لتوضيح كيفية عمل التقاط لقطات Chartshot، سننشئ خوارزمية cBot بسيطة ستلتقط لقطة chartshot للرسم البياني الحالي وتحفظها في نظام الملفات على جهازك المحلي.

 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

using System;
using System.IO;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using cAlgo.API;
using cAlgo.API.Collections;
using cAlgo.API.Indicators;
using cAlgo.API.Internals;

namespace cAlgo.Robots
{
    [Robot(AccessRights = AccessRights.FullAccess)]
    public class ChartshotTest : Robot
    {
        protected override void OnStart()
        {
            if (Chart.IsActive)
            {
                var chartshot = Chart.TakeChartshot();

                File.WriteAllBytes(@"D://examplePath/chartshot.png", chartshot);

            }
        }
    }
}

عند البدء، ستتم إضافة ملف .PNG يحتوي على لقطة chartshot للرسم البياني الذي قمنا بإرفاق نسخة خوارزمية cBot به إلى D://examplePath/.

الملخص

تتيح طريقة TakeChartshot() لخوارزميات cTrader التقاط لقطات Chartshot قابلة للمشاركة بسهولة، مما يجعلها ضرورية لأي شخص يرغب في مشاركة المعلومات مع المتداولين الآخرين أو تتبع كيفية أداء حلوله الآلية استجابة لظروف معينة. هذه الطريقة قابلة للاستخدام أيضًا في الاختبار العكسي المرئي، مما يتيح لك مطابقة إجراءات خوارزميات cBot الخاصة بك بسهولة مع الأحداث التي تحدث على الرسوم البيانية.