CustomSymbolSetInteger

Устанавливает для пользовательского символа значение свойства целочисленного типа.

bool  CustomSymbolSetInteger(
   const string              symbol_name,      // имя символа
   ENUM_SYMBOL_INFO_INTEGER  property_id,      // идентификатор свойства
   long                      property_value    // значение свойства
   );

Параметры

symbol_name

[in]  Имя пользовательского символа.

property_id

[in]  Идентификатор свойства символа. Значение может быть одним из значений перечисления ENUM_SYMBOL_INFO_INTEGER.

property_value

[in]  Переменная типа long, содержащая значение свойства.

Возвращаемое значение

true – в случае успеха, иначе false. Чтобы получить информацию об ошибке, необходимо вызвать функцию GetLastError().

Примечание

Минутная и тиковая история пользовательского символа полностью удаляется, если в спецификации символа изменить любое из этих свойств:

  • SYMBOL_CHART_MODE – тип цены, который используется для построения баров (Bid или Last)
  • SYMBOL_DIGITS – количество знаков после запятой для отражения цены

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

 

Пример:

//+------------------------------------------------------------------+
//|                                       CustomSymbolSetInteger.mq5 |
//|                                  Copyright 2024, MetaQuotes Ltd. |
//|                                             https://www.mql5.com |
//+------------------------------------------------------------------+
#property copyright "Copyright 2024, MetaQuotes Ltd."
#property link      "https://www.mql5.com"
#property version   "1.00"
 
#define   CUSTOM_SYMBOL_NAME     Symbol()+".C"  // наименование пользовательского символа
#define   CUSTOM_SYMBOL_PATH     "Forex"        // название группы, в которой будет создан символ
#define   CUSTOM_SYMBOL_ORIGIN   Symbol()       // наименование символа, на основе которого будет создан пользовательский
 
//+------------------------------------------------------------------+
//| Script program start function                                    |
//+------------------------------------------------------------------+
void OnStart()
  {
//--- получаем код ошибки при создании пользовательского символа
   int create=CreateCustomSymbol(CUSTOM_SYMBOL_NAMECUSTOM_SYMBOL_PATHCUSTOM_SYMBOL_ORIGIN);
   
//--- если код ошибки не 0 (успешное создание символа) и не 5304 (символ уже создан) - уходим
   if(create!=0 && create!=5304)
      return;
      
//--- получим и распечатаем в журнале свойства символа, на основе которого создан пользовательский
//--- (режим заключения сделок, уровень установки Stop ордеров и дистанция заморозки торговых операций)
   ENUM_SYMBOL_TRADE_EXECUTION origin_exe_mode = (ENUM_SYMBOL_TRADE_EXECUTION)SymbolInfoInteger(CUSTOM_SYMBOL_ORIGINSYMBOL_TRADE_EXEMODE);
   int origin_stops_level = (int)SymbolInfoInteger(CUSTOM_SYMBOL_ORIGINSYMBOL_TRADE_STOPS_LEVEL);
   int origin_freeze_level= (int)SymbolInfoInteger(CUSTOM_SYMBOL_ORIGINSYMBOL_TRADE_FREEZE_LEVEL);
   
   PrintFormat("The '%s' symbol from which the custom '%s' was created:\n"+
               "  Deal execution mode: %s\n  Stops Level: %d\n  Freeze Level: %d",
               CUSTOM_SYMBOL_ORIGINCUSTOM_SYMBOL_NAME,
               StringSubstr(EnumToString(origin_exe_mode), 23), origin_stops_levelorigin_freeze_level);
   
//--- установим для этих свойств пользовательского символа иные значения
   ResetLastError();
   bool res=true;
   res &=CustomSymbolSetInteger(CUSTOM_SYMBOL_NAMESYMBOL_TRADE_EXEMODESYMBOL_TRADE_EXECUTION_MARKET);
   res &=CustomSymbolSetInteger(CUSTOM_SYMBOL_NAMESYMBOL_TRADE_STOPS_LEVEL10);
   res &=CustomSymbolSetInteger(CUSTOM_SYMBOL_NAMESYMBOL_TRADE_FREEZE_LEVEL3);
 
//--- если при установке какого-либо из свойств была ошибка - выведем об этом сообщение в журнал
   if(!res)
      Print("CustomSymbolSetInteger() failed. Error "GetLastError());
   
//--- получим и распечатаем в журнале изменённые свойства пользовательского символа
//--- (режим заключения сделок, уровень установки Stop ордеров и дистанция заморозки торговых операций)
   ENUM_SYMBOL_TRADE_EXECUTION custom_exe_mode = (ENUM_SYMBOL_TRADE_EXECUTION)SymbolInfoInteger(CUSTOM_SYMBOL_NAMESYMBOL_TRADE_EXEMODE);
   int custom_stops_level = (int)SymbolInfoInteger(CUSTOM_SYMBOL_NAMESYMBOL_TRADE_STOPS_LEVEL);
   int custom_freeze_level= (int)SymbolInfoInteger(CUSTOM_SYMBOL_NAMESYMBOL_TRADE_FREEZE_LEVEL);
   
   PrintFormat("Custom symbol '%s' based on '%s':\n"+
               "  Deal execution mode: %s\n  Stops Level: %d\n  Freeze Level: %d",
               CUSTOM_SYMBOL_NAMECUSTOM_SYMBOL_ORIGIN
               StringSubstr(EnumToString(custom_exe_mode), 23), custom_stops_levelcustom_freeze_level);
   
//--- выведем на график в комментарии подсказку о клавишах завершения работы скрипта
   Comment(StringFormat("Press 'Esc' to exit or 'Del' to delete the '%s' symbol and exit"CUSTOM_SYMBOL_NAME));
 
//--- в бесконечном цикле ожидаем нажатия клавиш Esc или Del для выхода
   while(!IsStopped() && TerminalInfoInteger(TERMINAL_KEYSTATE_ESCAPE)==0)
     {
      Sleep(16);
      //--- при нажатии Del, удаляем созданный пользовательский символ
      if(TerminalInfoInteger(TERMINAL_KEYSTATE_DELETE)<0)
        {
         if(DeleteCustomSymbol(CUSTOM_SYMBOL_NAME))
            PrintFormat("Custom symbol '%s' deleted successfully"CUSTOM_SYMBOL_NAME);
         break;
        }
     }
//--- перед выходом очистим график
   Comment("");
   /*
   результат:
   The 'EURUSDsymbol from which the custom 'EURUSD.Cwas created:
     Deal execution modeINSTANT
     Stops Level0
     Freeze Level0
   Custom symbol 'EURUSD.Cbased on 'EURUSD':
     Deal execution modeMARKET
     Stops Level10
     Freeze Level3
   */
  }
//+------------------------------------------------------------------+
//| Создаёт пользовательский символ, возвращает код ошибки           |
//+------------------------------------------------------------------+
int CreateCustomSymbol(const string symbol_nameconst string symbol_pathconst string symbol_origin=NULL)
  {
//--- определяем наименование символа, на основе которого будет создан пользовательский
   string origin=(symbol_origin==NULL ? Symbol() : symbol_origin);
   
//--- если пользовательский символ создать не удалось, и это не ошибка 5304 - сообщаем об этом в журнале
   ResetLastError();
   int error=0;
   if(!CustomSymbolCreate(symbol_namesymbol_pathorigin))
     {
      error=GetLastError();
      if(error!=5304)
         PrintFormat("CustomSymbolCreate(%s, %s, %s) failed. Error %d"symbol_namesymbol_pathoriginerror);
     }
//--- успешно
   return(error);
  }
//+------------------------------------------------------------------+
//| Удаляет пользовательский символ                                  |
//+------------------------------------------------------------------+
bool DeleteCustomSymbol(const string symbol_name)
  {
//--- скроем символ из окна Обзор рынка
   ResetLastError();
   if(!SymbolSelect(symbol_namefalse))
     {
      PrintFormat("SymbolSelect(%s, false) failed. Error %d"GetLastError());
      return(false);
     }
      
//--- если пользовательский символ удалить не удалось - сообщаем об этом в журнале и возвращаем false
   ResetLastError();
   if(!CustomSymbolDelete(symbol_name))
     {
      PrintFormat("CustomSymbolDelete(%s) failed. Error %d"symbol_nameGetLastError());
      return(false);
     }
//--- успешно
   return(true);
  }

 

Смотри также

SymbolInfoInteger