Asosiasi berkas plugin

Antarmuka FileAssociations menyediakan tipe yang memungkinkan plugin untuk mendaftarkan, memodifikasi, dan menangani ekstensi berkas secara fleksibel. Dengan tipe-tipe tersebut, pengembang dapat membuat kode plugin untuk mengelola asosiasi berkas. Ketika plugin diaktifkan, cTrader mengenali dan mengarahkan berkas yang relevan ke plugin untuk diproses.

Dengan plugin yang dikonfigurasi untuk menangani berkas langsung di UI cTrader, pengguna mungkin tidak perlu lagi beralih antara beberapa aplikasi saat bekerja dengan berkas. Misalnya, plugin dapat dibuat untuk membuka dan mengelola semua berkas yang digunakan dengan strategi trading tertentu.

Operasi

Instal plugin

Ketika pengguna cTrader menginstal dan mengaktifkan plugin yang mendukung tipe berkas tertentu untuk pertama kalinya, sebuah dialog muncul. Pengguna diminta untuk mengaitkan ekstensi berkas dengan plugin tersebut.

Setelah pengguna mengonfirmasi operasi tersebut, komputer mereka memperbarui pengaturan asosiasi berkas di seluruh sistem, dan konfigurasi baru diterapkan segera.

Ikon baru untuk tipe berkas tersebut menjadi terlihat di File Explorer. Jika ikon tidak disediakan untuk tipe berkas tersebut, ikon plugin default akan digunakan.

Gunakan plugin

Jika plugin yang mendukung ekstensi file diaktifkan di cTrader, plugin tersebut akan dipanggil untuk bekerja dengan file ketika pengguna melakukan salah satu dari hal berikut:

• Seret dan lepas file - pengguna dapat menyeret file yang didukung dan melepaskannya ke UI cTrader.

• Buka file di File Explorer - pengguna dapat mengklik dua kali file untuk membukanya atau menggunakan opsi Buka dengan dan memilih cTrader.

  • Jika aplikasi cTrader terbuka, plugin akan langsung menerima file tersebut.
  • Jika aplikasi cTrader tertutup, cTrader akan diluncurkan terlebih dahulu dan kemudian plugin menerima file tersebut.

File yang diterima disalin ke folder data untuk plugin dan dihapus setelah plugin selesai memprosesnya.

Path ke folder data untuk plugin: …/Documents/cAlgo/Data/Plugins/{PluginName}/Temp.

Dalam kasus di mana ekstensi file dikaitkan dengan beberapa plugin yang diaktifkan, setiap plugin akan memproses file tersebut secara independen.

Ketika asosiasi file dihapus karena plugin yang relevan dinonaktifkan dalam instance cTrader, asosiasi file tersebut secara otomatis ditambahkan kembali di instance cTrader lain di mana plugin yang sama diaktifkan.

Lakukan penggantian manual

Jika pengguna kemudian mengubah program default untuk jenis file tertentu dalam pengaturan komputer reguler mereka, cTrader secara otomatis berhenti menangani jenis file tersebut.

Untuk mengatur cTrader sebagai program default untuk menangani file dalam format tersebut lagi, pengguna harus membuat ulang asosiasi file dengan cara berikut:

1. Buka cTrader dan nonaktifkan plugin yang relevan.
2. Aktifkan plugin tersebut. Ketika dialog muncul, konfirmasi operasi tersebut.

Pengaturan ini membantu plugin dan aplikasi cTrader mengelola ekstensi file sambil menghindari gangguan dari program lain.

Contoh plugin

Plugin contoh ini hanya menambahkan asosiasi file untuk jenis file berikut:

• 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}");
        }
    }
}