Под разметкой советника обычно понимают служебные строки и блоки, которые задают поведение программы до запуска торговой логики: свойства файла, параметры входа, макросы, типы и обязательные обработчики. От них зависит, появится ли советник в навигаторе, покажутся ли настройки в окне параметров и не рассыплется ли код при первой правке.
Что относится к разметке
- директивы
#property- имя, версия, ссылка, иконка, режим торговли; - параметры входа
inputиexternвместе с перечислениями; - макросы
#define, включения#includeи ресурсы#resource; - объявление типов:
enum,struct, глобальные переменные; - каркас из
OnInit,OnTick,OnDeinit; - оформление: отступы, префиксы имён, разделители и комментарии.
Директивы #property
Это метаданные файла. Они не выполняются, но терминал читает их при загрузке: от них зависят подпись в окне параметров, авторство и иконка.
| Директива | Зачем нужна |
|---|---|
| #property copyright | автор программы в окне «О программе» |
| #property link | ссылка на сайт автора |
| #property version | версия, видна в свойствах |
| #property description | описание в окне свойств |
| #property strict | строгая типизация (включать всегда) |
| #property show_inputs | показывать окно параметров перед запуском (скрипты) |
| #property indicator_chart_window | рисовать индикатор на графике цены |
| #property indicator_buffers | число буферов индикатора |
| #property indicator_color1 | цвет первой линии |
Основные директивы. Для экспертов достаточно первых пяти.
Параметры входа: input, enum, подписи
Параметр объявляется через input и сразу получает тип, значение по умолчанию и подпись после двух слэшей. Именно эта подпись показывается в окне настроек советника - по ней трейдер понимает, что менять.
//+------------------------------------------------------------------+
//| ai_news_expert.mq4 |
//| пример из статьи на forex-robot.store |
//+------------------------------------------------------------------+
#property copyright "forex-robot.store"
#property link "https://forex-robot.store/"
#property version "1.00"
#property strict
input int MagicNumber = 202601;
input double RiskPercent = 0.5;
input int StartHour = 8;
input int EndHour = 20;
datetime g_lastBarTime = 0;
//+------------------------------------------------------------------+
int OnInit()
{
Print("Советник запущен: символ ", Symbol(), ", период ", Period());
return(INIT_SUCCEEDED);
}
//+------------------------------------------------------------------+
void OnDeinit(const int reason)
{
Comment("");
Print("Советник остановлен, причина: ", reason);
}
//+------------------------------------------------------------------+
void OnTick()
{
if(!IsTradeAllowed())
return;
if(!IsTradingHour())
{
Comment("Вне торгового окна: ", StartHour, "-", EndHour, " ч.");
return;
}
// работаем один раз на закрытии бара
if(Time[0] == g_lastBarTime)
return;
g_lastBarTime = Time[0];
double atr = iATR(NULL, 0, 14, 1);
if(atr <= 0)
return;
Comment(StringFormat("Бар %s | Bid %.5f | ATR %.5f | лот %.2f",
TimeToString(Time[0], TIME_DATE | TIME_MINUTES),
Bid, atr, LotForRisk(RiskPercent)));
}
//+------------------------------------------------------------------+
bool IsTradingHour()
{
int hour = Hour();
return(hour >= StartHour && hour < EndHour);
}
//+------------------------------------------------------------------+
double LotForRisk(double percent)
{
double riskMoney = AccountBalance() * percent / 100.0;
double tickValue = MarketInfo(Symbol(), MODE_TICKVALUE);
if(tickValue <= 0)
return(0.01);
return(NormalizeDouble(riskMoney / tickValue / 1000.0, 2));
}В примере видно три приёма: числовые параметры с понятными подписями, перечисление ENUM_TRADE_MODE для режима работы и проверка корректности в OnInit с возвратом INIT_PARAMETERS_INCORRECT. Если параметр вне допустимого диапазона, советник не запустится и напишет причину - это лучше, чем молча торговать с нулевым лотом.
Макросы, включения и ресурсы
#define MAX_ORDERS 5- константа препроцессора: меняется в одном месте, не занимает память;#include <fxr.mqh>- подключает общий код из MQL4/Include; угловые скобки ищут в Include, кавычки - рядом с файлом;#resource "expert.bmp"- встраивает картинку в ex4, чтобы не тащить файл рядом с программой;#ifdef / #ifndef- защита заголовочного файла от двойного включения.
Осторожно с #define: это текстовая подстановка. Конструкция #define SQUARE(x) x*x при вызове SQUARE(a+b) даст неверный результат. Для функций лучше писать обычные функции, а макросы оставить для констант.
Перечисления, структуры и глобальные переменные
Когда параметров больше пяти, их объединяют в перечисления и структуры: код становится короче, а компилятор ловит опечатки. Пример ниже показывает полный набор разметки - макросы, enum, struct, input, глобальную переменную и вспомогательные функции.
//+------------------------------------------------------------------+
//| ai_news_markup.mq4 |
//| пример из статьи на forex-robot.store |
//+------------------------------------------------------------------+
#property copyright "forex-robot.store"
#property link "https://forex-robot.store/"
#property version "1.00"
#property strict
#define EA_NAME "Markup Demo"
#define MAX_ORDERS 5
enum ENUM_TRADE_MODE
{
MODE_MANUAL = 0, // Ручной
MODE_AUTO = 1, // Автоматический
MODE_BY_SIGNAL = 2 // По сигналу
};
struct SignalInfo
{
string symbol;
datetime time;
ENUM_TRADE_MODE mode;
double price;
int direction; // +1 покупка, -1 продажа
};
input ENUM_TRADE_MODE InpMode = MODE_AUTO;
input int InpMaxOrders = MAX_ORDERS;
input double InpLot = 0.01;
input string InpComment = EA_NAME;
SignalInfo g_lastSignal;
//+------------------------------------------------------------------+
int OnInit()
{
if(InpMaxOrders <= 0 || InpMaxOrders > MAX_ORDERS)
{
Print("Некорректный лимит ордеров: ", InpMaxOrders);
return(INIT_PARAMETERS_INCORRECT);
}
g_lastSignal.symbol = Symbol();
g_lastSignal.time = Time[0];
g_lastSignal.mode = InpMode;
g_lastSignal.price = Bid;
g_lastSignal.direction = 0;
Print(EA_NAME, " инициализирован: режим ", EnumToString(InpMode));
return(INIT_SUCCEEDED);
}
//+------------------------------------------------------------------+
void OnTick()
{
if(InpMode == MODE_MANUAL)
return;
SignalInfo signal;
signal.symbol = Symbol();
signal.time = Time[0];
signal.mode = InpMode;
signal.price = (Bid + Ask) / 2.0;
signal.direction = TrendDirection();
if(signal.direction == 0)
return;
g_lastSignal = signal;
if(CountOpen() >= InpMaxOrders)
return;
Comment(StringFormat("%s | %s | %s | цена %.5f | ордеров %d/%d",
EA_NAME, signal.symbol, EnumToString(signal.mode),
signal.price, CountOpen(), InpMaxOrders));
}
//+------------------------------------------------------------------+
int TrendDirection()
{
double fast = iMA(NULL, 0, 10, 0, MODE_EMA, PRICE_CLOSE, 1);
double slow = iMA(NULL, 0, 50, 0, MODE_EMA, PRICE_CLOSE, 1);
if(fast > slow) return(1);
if(fast < slow) return(-1);
return(0);
}
//+------------------------------------------------------------------+
int CountOpen()
{
int total = 0;
for(int i = OrdersTotal() - 1; i >= 0; i--)
{
if(!OrderSelect(i, SELECT_BY_POS, MODE_TRADES))
continue;
if(OrderSymbol() != Symbol())
continue;
total++;
}
return(total);
}Обратите внимание: одно из значений перечисления пришлось переименовать. MODE_SIGNAL - уже занятое в MQL4 имя (константа прикладной цены), и компилятор выдаёт ошибку "identifier expected". Перед объявлением своих констант полезно проверять их по справке F1.
Каркас советника: три обязательных блока
Любой эксперт - это три обработчика и вспомогательные функции. Разметка каркаса выглядит так:
OnInit()- возвращает INIT_SUCCEEDED или код ошибки инициализации;OnTick()- вызывается на каждом тике, здесь проверяютIsTradeAllowed()и новизну бара;OnDeinit(const int reason)- вызывается при снятии, смене символа, перекомпиляции; reason говорит, почему остановились.
Комментарий в начале файла с назначением, версией и автором - не формальность: через полгода именно он объясняет, зачем в коде появился странный блок.
Правила оформления, которые экономят время
- имена глобальных переменных - с префиксом
g_, параметров - сInp: сразу видно, откуда переменная; - отступ 3 пробела (стиль MetaEditor) и фигурные скобки на новой строке;
- одна функция - одна задача: расчёт лота, проверка времени и торговля в разных функциях;
- разделители
//+---...---+перед каждой функцией: по ним удобно навигировать; - все магические числа (30 пунктов, 0.01 лота) - в параметры или константы;
- проверка результата каждой торговой функции и вывод
GetLastError()в лог.
Если придерживаться этой разметки, советник компилируется без предупреждений и его можно передавать другому разработчику. Продолжение темы - основы программирования в MetaTrader 4 и разбор эксперта, индикатора и скрипта.
