Язык программирования MQL4

Устанавливает значение для указанного горизонтального уровня индикатора, выводимого

в отдельное окно.

Параметры:

level - номер уровня (0-31).

value - значение для указанного уровня.

Использование горизонтальных уровней бывает очень удобно в тех случаях, когда

необходимо зрительно определить находится ли индикаторная линия выше или ниже

некоторых заданных значений. Представленный ниже простой индикатор рассчитывает

разницу между максимальной и минимальной ценами бара. События на рынке

представляют интерес для пользователя (условно, в данном примере), если индикаторная

линия находится выше уровня 0.001 или ниже уровня -0.001. Пример индикатора,

отображающего разницу High и Low (linelevel.mq4).

//--------------------------------------------------------------------

// linelevel.mq4

// Предназначен для использования в качестве примера в учебнике MQL4.

//--------------------------------------------------------------- 1 --

#property indicator_separate_window // Индик. рисуется в отдельн. окне

#property indicator_buffers 1 // Количество буферов

#property indicator_color1 Red // Цвет линии

double Buf_0[]; // Открытие индикаторного массива

//--------------------------------------------------------------- 2 --

int init() // Специальная функция init()

{

SetIndexBuffer(0,Buf_0); // Назначение массива буферу

SetIndexStyle (0,DRAW_LINE,STYLE_SOLID,2);// Стиль линии

SetIndexLabel (0,"Разница High и Low");

SetLevelValue (0, 0.0010); // Задан уровень горизонт. линии

SetLevelValue (1,-0.0010); // Задан ещё один уровень

return; // Выход из спец. ф-ии init()

}

//--------------------------------------------------------------- 3 --

int start() // Специальная функция start()

{

int i, // Индекс бара

Counted_bars; // Количество просчитанных баров

Counted_bars=IndicatorCounted(); // Количество просчитанных баров

i=Bars-Counted_bars-1; // Индекс первого непосчитанного

511

while(i>=0) // Цикл по непосчитанным барам

{

Buf_0[i]=High[i]-Low[i]; // Значение 0 буфера на i-ом баре

if(Open[i]>Close[i]) // Если свеча чёрная..

Buf_0[i]=-Buf_0[i]; // .. то реверс значения

i--; // Расчёт индекса следующего бара

}

return; // Выход из спец. ф-ии start()

}

//--------------------------------------------------------------- 4 --

Рассматриваемая функция используется в индикаторе в блоке 2-3. В данном случае задано

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

горизонтального уровня, а второе - заданное значение уровня:

SetLevelValue (0, 0.0010); // Задан уровень горизонт. линии

SetLevelValue (1,-0.0010); // Задан ещё один уровень

Параметры настроенных таким образом индикаторов indicatorstyle.mq4 и linelevel.mq4

отражаются в окне финансового инструмента и в окне данных.

Рис. 154. Отображение настроек индикаторов в различных окнах клиентского терминала.

На Рис. 154 представлено два окна - окно данных и окно финансового инструмента. В

окне данных можно наблюдать строку, содержащую текст "Линия High" и значение

1.3641. Такие же надписи отображаются в нижней строке всплывающей подсказки. В окне

данных указанная строка присутствует в течение всего времени исполнения индикатора,

512

название линии при этом не изменяется, а значение в правой части строки зависит от

места положения курсора в окне финансового инструмента. Название линии,

отображаемое во всплывающей подсказке, соответствует той индикаторной линии, к

которой подведен курсор.

В подокне индикатора linelevel.mq4 отображены горизонтальные линии, установленные в

соответствии со значениями, заданными пользователем. Если подвести стрелку курсора к

красной индикаторной линии, то во всплывающей подсказке можно видеть название этой

линии, в данном случае "Разница High и Low", и чуть правее - значение линии в точке

курсора.

9.6.10.5 Функции для настройки пользовательских индикаторов

Функция Краткое описание

IndicatorBuffers Распределяет память для буферов, используемых для

вычислений пользовательского индикатора. Количество

буферов не может превышать 8 и быть менее значения,

указанного в директиве #property indicator_buffers. Если

пользовательский индикатор требует дополнительных буферов

для счета, следует использовать эту функцию для указания

общего числа буферов.

IndicatorCounted Функция возвращает количество баров, не измененных после

последнего вызова индикатора. Большинство подсчитанных

баров не нуждается в пересчете.

IndicatorDigits Установка формата точности (количество знаков после

десятичной точки) для визуализации значений индикатора.

IndicatorShortName Установка "короткого" имени пользовательского индикатора

для отображения в подокне индикатора и в окне DataWindow.

SetIndexArrow Назначение значка для линии индикаторов, имеющей стиль

DRAW_ARROW.

513

SetIndexBuffer Связывает переменную-массив, объявленный на глобальном

уровне, с предопределенным буфером пользовательского

индикатора.

SetIndexDrawBegin Установка порядкового номера бара от начала данных, с

которого должна начинаться отрисовка указанной линии

индикатора.

SetIndexEmptyValu

e

Устанавливает значение пустой величины для линии

индикатора. Пустые значения не рисуются и не показываются в

DataWindow.

SetIndexLabel Установка имени линии индикатора для отображения

информации в окне DataWindow и всплывающей подсказке.

SetIndexShift Установка смещения линии индикатора относительно начала

графика. При положительном значении изображение линии

смещается вправо, при отрицательном - влево. Т.е. значение,

рассчитанное на текущем баре, рисуется с указанным

смещением относительно текущего бара.

SetIndexStyle Устанавливает новый тип, стиль, ширину и цвет для указанной

линии индикатора (см. Стили отображения индикаторных

линий).

SetLevelStyle Устанавливает новый стиль, ширину и цвет для

горизонтальных уровней индикатора, выводимого в отдельное

окно (см. Стили отображения индикаторных линий).

SetLevelValue Устанавливает значение для указанного горизонтального

уровня индикатора, выводимого в отдельное окно.

Для получения подробного описания этих и других функций необходимо обратиться к

справочной документации на MQL4.community, сайте MetaQuotes Software Corp. или к

разделу "Справка" в редакторе MetaEditor

514

9.3.11 Информация о счёте

Функции клиентского терминала и проверки состояния удобно применять, например, для

ограничения использования программ при коммерческом распространении. Рассмотрим,

как может быть решена такая задача:

Задача 39. Представить защитный код программы, распространяемой

на коммерческой основе, удовлетворяющий следующим требованиям:

для исполнения программы на реальных счетах индивидуальных

клиентов требуется ввести пароль;

для исполнения программы на реальных счетах корпоративных

клиентов пароль не требуется;

ограничения при исполнении программы на демо-счёте не

предусмотрены.

В этом примере правильно сформулирована постановка задачи. Для успешного

коммерческого распространения в распоряжение потенциальных потребителей

необходимо предоставить программу, которая в полной мере может быть опробована на

демо-счёте. При этом пользователь может оценить все достоинства программы и принять

решение о её приобретении.

Применять один общий пароль для всех клиентов неправильно - в этом случае появляется

риск несанкционированного распространения программы. Поэтому для индивидуальных

клиентов пароль должен быть поставлен в зависимость от номера реального счёта. Для

корпоративных клиентов (если дилинговый центр приобрёл лицензию для всех своих

трейдеров) использовать пароль нет необходимости - программа должна сама определить,

к какому серверу подключён клиентский терминал. И если это сервер корпоративного

клиента, то необходимо предоставить любому пользователю возможность

беспрепятственной работы.

Решение Задачи 39 для ограничения прав использования программ может быть таким

(эксперт сheck.mq4):

//--------------------------------------------------------------------

// сheck.mq4

// Предназначен для использования в качестве примера в учебнике MQL4.

515

//--------------------------------------------------------------- 1 --

extern int Parol=12345;

//--------------------------------------------------------------- 2 --

int start() // Спец. функция start

{

if(Check()==false) // Если условия использования..

return; // ..не выполняются, то выход

// Здесь должен быть указан основной код программы

Alert("Исполнение программы"); // Алерт для примера

return; // Выход из start()

}

//--------------------------------------------------------------- 3 --

bool Check() // Пользов. функция проверки ..

{ // .. условий использования

if (IsDemo()==true) // Если это демо-счёт, то..

return(true); // .. других ограничений нет

if (AccountCompany()=="SuperBank") // Для корпоративных клиентов..

return(true); // ..пароль не нужен

int Key=AccountNumber()*2+1000001; // Вычисляем ключ

if (Parol==Key) // Если пароль верный, то..

return(true); // ..разрешаем работу на реале

Alert("Неправильный пароль. Эксперт не работает.");

return(false); // Выход из пользов. функции

}

//--------------------------------------------------------------- 4 --

В данном примере необходимая проверка выполняется в первых строках специальной

функции start (блок 2-3):

if(Check()==false) // Если условия использования..

Если в результате выполнения проверки пользовательская функция Check() (блок 3-4)

вернула false, то управление передаётся на оператор return и специальная функция start()

заканчивает работу. Основной код программы располагается непосредственно после

указанной проверки. В результате успешной проверки функция Check() вернёт true, в этом

случае основной код программы будет исполнен.

В пользовательской функции Check() выполняется проверка по трём критериям:

- является ли счёт демонстрационным;

- принадлежит ли сервер корпоративному клиенту;

- подходит ли пароль к реальному счёту.

Для проверки по первому критерию используется функция IsDemo().

516

9.3.11.1 Функция IsDemo()

bool IsDemo()

Функция возвращает TRUE, если программа работает на демонстрационном счете, в

противном случае возвращает FALSE.

Если функция IsDemo() возвращает true, то пользователь работает на демо-счёте. Это

значит, что выполнять другие проверки нет необходимости (т.к. опробование программы

на демо-счёте позволено для всех желающих). В этом случае функция Check() прекращает

работу, и возвращает значение true:

if (IsDemo() == true) // Если это демо-счёт, то..

return(true); // .. других ограничений нет

Если же в функция IsDemo() вернёт значение false, значит, пользователь работает на

реальном счёте. В этом случае необходимо выяснить, достаточно ли у пользователя прав.

В данном примере сначала выполняется проверка корпоративных клиентов, для этого

используется функция AccountCompany().

9.3.11.2 Функция AccountCompany()

string AccountCompany()

Функция возвращает название брокерской компании, в которой зарегистрирован текущий

счет.

Если в результате выполнения проверки:

if (AccountCompany() == "SuperBank")// Для корпоративных клиентов..

return(true); // ..пароль не нужен

установлено, что название компании совпадает с тем, что указано в программе, то

функция Check() закончит работу и вернёт true - проверка закончена успешно. Если же

оказывается, что клиент подключен к другой компании (не являющейся корпоративным

клиентом), то необходимо выяснить имеет ли он индивидуальную лицензию.

В строке:

int Key = AccountNumber()*2+1000001;// Вычисляем ключ

в программу заложен алгоритм вычисления ключа для любого номера счёта. В данном

примере это простой способ. Программист по своему усмотрению может ввести в

программу другой, более сложный способ вычисления ключа. В любом случае алгоритм

517

вычисления ключа должен учитывать номер счёта, который доступен программе через

функцию AccountNumber().

9.3.11.3 Функция AccountNumber()

int AccountNumber()

Функция возвращает номер текущего счета.

Ранее вычисленный по тому же алгоритму пароль передаётся пользователю. Если в

результате проверки оказывается, что пароль и ключ совпадают, то функция Check()

прекращает работу и возвращает значение true:

if (Parol == Key) // Если пароль верный, то..

return(true); // ..разрешаем работу на реале

Если ни одна из проверок не закончилась успешно, это означает, что пользователь не

имеет права применения данной программы на реальном счёте. В этом случае, после

соответствующего уведомления, функция Check() прекращает работу и возвращает

значение false. Таким образом пресекается попытка несанкционированного использования

программы.

9.3.11.4 Функции, возвращающие информацию о клиентском терминале

Функция Краткое описание

TerminalCompan

y

Возвращает наименование компании-владельца клиентского

терминала.

TerminalName Возвращает имя клиентского терминала.

TerminalPath Возвращает директорий, из которого запущен клиентский

терминал.

9.3.11.5.Функции, позволяющие определить текущее состояние

клиентского терминала, в том числе состояние окружения выполняемой

MQL4-программы

518

Функция Краткое описание

GetLastError Функция возвращает код последней ошибки, после чего

значение специальной переменной last_error, в которой хранится

код последней ошибки, обнуляется. Так что последующий вызов

GetLastError() вернет значение 0.

IsConnected Возвращает состояние главного соединения клиентского

терминала с сервером, по которому производится подкачка

данных. TRUE - связь с сервером установлена, FALSE - связь с

сервером отсутствует или прервана.

IsDemo Возвращается TRUE, если программа работает на

демонстрационном счете, в противном случае возвращает

FALSE.

IsDllsAllowed Возвращает TRUE, если DLL вызов функции разрешены для

эксперта, иначе возвращает FALSE.

IsExpertEnabled Возвращает TRUE, если в клиентском терминале разрешен

запуск экспертов, иначе возвращает FALSE.

IsLibrariesAllowed Возвращает TRUE, если эксперт может назвать библиотечную

функцию, иначе возвращает FALSE.

IsOptimization Возвращается TRUE, если эксперт работает в режиме

оптимизации тестирования, иначе возвращает FALSE.

IsStopped Возвращается TRUE, если программа (эксперт или скрипт)

получила команду на завершение своей работы, иначе

возвращает FALSE.

IsTesting Возвращается TRUE, если эксперт работает в режиме

тестирования, иначе возвращает FALSE.

IsTradeAllowed Возвращается TRUE, если эксперту разрешено торговать и

поток для выполнения торговых операций свободен, иначе

519

возвращает FALSE.

IsTradeContextBus

y

Возвращается TRUE, если поток для выполнения торговых

операций занят, иначе возвращает FALSE.

IsVisualMode Возвращается TRUE, если эксперт тестируется в режиме

визуализации, иначе возвращает FALSE.

UninitializeReason Возвращает код причины завершения экспертов,

пользовательских индикаторов и скриптов. Возвращаемые

значения могут быть одним из кодов деинициализации. Эту

функцию можно также вызывать в функции init() для анализа

причин деинициализации предыдущего запуска.

9.3.11.6 Функции для доступа к информации об активном счете

Функция Краткое описание

AccountBalance Возвращает значение баланса активного счета (сумма

денежных средств на счете).

AccountCredit Возвращает значение кредита для активного счета.

AccountCompany Возвращает название брокерской компании, в которой

зарегистрирован текущий счет.

AccountCurrency Возвращает наименование валюты для текущего счета.

AccountEquity Возвращает сумму собственных средств для текущего

счета. Расчет equity зависит от настроек торгового сервера.

AccountFreeMargin Возвращает значение свободных средств, разрешенных

для открытия позиций на текущем счете.

AccountFreeMarginChec

k

Возвращает размер свободных средств, которые останутся

после открытия указанной позиции по текущей цене на

520

Язык программирования MQL4

Подождите немного. Документ загружается.