/////////////////////////////////////////////////////// // // SaherElm IT Center MQL5 Class Library // ---------------------------------------------- // Name: XSCX5EA // Description: provides all X5 EA requirements ... // - X5 Provider; // // // Maintainer: // ------------ // Hadi Khazaee Asl (hadi_khazaee_asl@yahoo.com) // ////////////////////////////////////////////////////// // // Global Properties ... #property library #property copyright "Copyright 2023, SaherElm IT Center" #property link "https://www.saherelm.ir" #property version "1.00" #property strict // // Imports ... #include "../Classes/x-saherelm.xea.class.mq5" #include "../Classes/x-saherelm.x5.provider.class.mq5" // // Define On Signal Event Handler Type Specified for X5 ... typedef void (*TX5OnSignal)(X5ProviderDescriptor &descriptor); // // Class Definition ... class XSCX5EA : public XSCBaseEA { // // Public ... public: // // Props ... // // Constructors ... XSCX5EA( // // XTrade Class Requirements ... int slippage, // Specify Slippage ulong magicNumber, // Specify Magic Number int manageInterval, // Manager Check Intervals Seconds double maxAllowedSpread, // Max Allowed Spred for Opening Trades int maxAllowedPositions, // Max Allowed Positions double maxAllowedDrawdownFactor, // Max Allowed Drawdown Factor // // Position Management ... bool allowLong = true, // Allow Long Trades bool allowShort = true, // Allow Short Trades double minProfitPerTrade = 0, // Min Profit Per Trade based On Volume Factor (Hedge) double minProfitPerVolumeFactor = 0, // Min Volume Factor for Calculating Profit (Hedge) // // Event Handlers ... TOnStopLoss onStopLossTriggered = NULL, // On StopLoass Triggered Event Handler TOnTakeProfit onTakeProfitTriggered = NULL, // On TakeProfit Triggered Event Handler TOnDealsChanged onDealsChangedHandler = NULL, // On Deals Changed Event Handler TOnOrdersChanged onOrdersChangedHandler = NULL, // On Orders Changed Event Handler TOnPositionsChanged onPositionsChangedHandler = NULL, // On Positions Changed Event Handler TOnTradeStateChanged onTradeStateChangedHandler = NULL, // On Trade State Changed Event Handler // TOnSignal onSignalHandler = NULL, // On Signal Event Handler // // Log Handler ... bool enableAlerts = true, // Enable Alerts bool logAlerts = true, // Log Alerts bool terminalAlerts = false, // Terminal Alerts bool mailAlerts = false, // Mail Alerts bool pushAlerts = false // Push Alerts ) : XSCBaseEA(slippage, magicNumber, manageInterval, maxAllowedSpread, maxAllowedPositions, maxAllowedDrawdownFactor, allowLong, allowShort, minProfitPerTrade, minProfitPerVolumeFactor, onStopLossTriggered, onTakeProfitTriggered, onDealsChangedHandler, onOrdersChangedHandler, onPositionsChangedHandler, onTradeStateChangedHandler, enableAlerts, logAlerts, terminalAlerts, mailAlerts, pushAlerts // ) { } // // Deconstructor ... ~XSCX5EA() {} // // Properties Getter(s) / Setter(s) ... // // Add X5 Specified Signal Event Handler ... void AddOnSignalEventHandler(TX5OnSignal listener) { // Add( listener, mX5OnSignalEventHandlers // ); } // // Add Specified X5 Provider ... bool AddProvider(X5ProviderDescriptor &descriptor) { // bool result = false; // // Validate Inputs ... result = descriptor.Init(); if (!result) { return result; } // AddRef( descriptor, mDescriptors // ); // return result; } // // Overrides ... // // Customize Token ... string GetToken() override { return GetSpecificToken(this); } // string GetTag() override { return this.GetToken(); } // // Check Provider for any Guards ... bool CheckForGuard(XGuard &guards[]) override { // // TODO: Implement this ... return false; } // // Request Provider to Collect all // Potentially Signals and then // filters theme here and passed them // for Executing ... int RequestForSignal( XSignal &signals[] // Holds Signals ... ) override { // bool result = 0; // Clean(signals); // int descriptorsCount = CountDescriptors(); if (descriptorsCount <= 0) { return result; } // for (int i = 0; i < descriptorsCount; i++) { // X5ProviderDescriptor iDescriptor = mDescriptors[i]; // bool iHasSignal = iDescriptor.HasSignal(); if (iHasSignal) { // // Here we Can double check Signals by Conditions // for Score Base Filtering ... // AddRef( iDescriptor.signal, signals // ); // NotifyX5OnSignalEventHandlers(iDescriptor); } } // result = ArraySize(signals); // return result; } // // Handl Management Actions ... // if returns true, it is going to prevent for processing forward ... bool HandleStateManagement() override { // // TODO: Implement this ... return false; } // // Request for Support Signals using Guard ... bool RequestForSupport( XSignal &support, // Holds Support Signal, if Provided string provider, // Positions Provided by Specific Provider string symbol, // Trading Symbol ENUM_POSITION_TYPE type, // Trading Type ENUM_TIMEFRAMES period // Specified Time Frame ) override { // // TODO: Implement this ... return false; } // // Tools ... // // Protected ... protected: // // Tools ... // void NotifyX5OnSignalEventHandlers(X5ProviderDescriptor &descriptor) { // int listenersCount = ArraySize(mX5OnSignalEventHandlers); if (listenersCount <= 0) { return; } // for (int i = 0; i < listenersCount; i++) { // TX5OnSignal iListener = mX5OnSignalEventHandlers[i]; // iListener(descriptor); } } // // Private ... private: // // Props ... // // Collection of Signal Event Listeners ... TX5OnSignal mX5OnSignalEventHandlers[]; // // a Collection of X5 Provider Descriptors ... X5ProviderDescriptor mDescriptors[]; // int CountDescriptors() { return ArraySize(mDescriptors); } // // Tools ... }; // // Tools ...