Курс USD на 22 ноября 82.19р
ISTORE2021
Телеграм E-mail
Ваша корзина пуста!
Корзина
Добавлено: 22.11.2026 Обновлено: 22.11.2026 Просмотров: 22

Под разметкой советника обычно понимают служебные строки и блоки, которые задают поведение программы до запуска торговой логики: свойства файла, параметры входа, макросы, типы и обязательные обработчики. От них зависит, появится ли советник в навигаторе, покажутся ли настройки в окне параметров и не рассыплется ли код при первой правке.

Что относится к разметке

  • директивы #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 и разбор эксперта, индикатора и скрипта.


22.11.2026 22
Последние статьи
Исходный код 22.11.2026 24
Чем отличаются эксперт, индикатор и скрипт в MetaTrader 4
В MetaTrader 4 три вида программ, и новички часто путают их местами: советник не рисует линию, индик..
Исходный код 22.11.2026 32
Основы программирования в MetaTrader 4: что такое MQL4 и с чего начать
MetaTrader 4 и его язык MQL4 - самая массовая среда для торговых роботов: на ней до сих пор работает..
Советник Трейдинг с AI: мультивалютная торговля по AI-сигналам
«Трейдинг с AI» (в терминале - AI Trader v6.0) - мультивалютный советник для MetaTrader 4: он получа..
Проглот 11.0: как работает и как установить
Советник Проглот 11.0 - это сеточный торговый робот для MetaTrader 4, который открывает сделки от кл..
Обзор рынка в MetaTrader 4: как пользоваться
Обзор рынка в MetaTrader 4 (Ctrl+M) - это список символов, из которого терминал берёт котировки для ..
Рекомендуем
Лидер продаж!
Traide Ringer 9
Traide Ringer 9
Traide Ringer - полностью переработанный, мощный и интеллектуальный мультивалютный торговый робо..
Варианты покупки
20 отзывов
0руб.
QUATTRO PRO
Мы официальные представители и партнеры проекта QUATTRO и предлагаем всех роботов от разработчика с ..
18 отзывов
50 000руб.
Лидер продаж!
Scalper Avtomat 7.0
Scalper Avtomat 7.0
AvtomatFx_Scalper - Торговый советник, скальпер, для терминалов МТ4. Советник используется для разго..
12 отзывов
2 900руб.
Балансировщик Про Лок
Балансировщик Про Лок - это автоматический советник для MetaTrader 4, который помогает выходить ..
2 отзыва
5 000руб.
Лидер продаж!
Стохастик с сеткой 2026
Стохастик с сеткой 2026
Stochastic Grid 2026 — это полностью автоматизированный торговый советник, который объединяет ..
* Варианты покупки
1 отзыв
5 000руб.
Наш сайт использует cookie и другие технологии. Продолжая им пользоваться, вы соглашаетесь на обработку персональных данных в соответствии с политикой конфиденциальности.