Справочник по языку программирования MQL5

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

Стандартные константы, перечисления и структуры

191

#define KEY_NUMPAD_5 12

#define KEY_LEFT 37

#define KEY_UP 38

#define KEY_RIGHT 39

#define KEY_DOWN 40

#define KEY_NUMLOCK_DOWN 98

#define KEY_NUMLOCK_LEFT 100

#define KEY_NUMLOCK_5 101

#define KEY_NUMLOCK_RIGHT 102

#define KEY_NUMLOCK_UP 104

//+------------------------------------------------------------------+

//| Expert initialization function |

//+------------------------------------------------------------------+

int OnInit()

{

//---

Print("Запущен эксперт с именем ",MQL5InfoString(MQL5_PROGRAM_NAME));

//---

return(0);

}

//+------------------------------------------------------------------+

//| |

//+------------------------------------------------------------------+

void OnChartEvent(const int id, // идентификатор события

const long& lparam, // параметр события типа long

const double& dparam, // параметр события типа double

const string& sparam // параметр события типа string

)

{

//--- нажатие левой кнопкой мышки на графике

if(id==CHARTEVENT_CLICK)

{

Print("Координаты щелчка мышки на графике: x = ",lparam," y = ",dparam);

}

//--- нажатие мышкой на графическом объекте

if(id==CHARTEVENT_OBJECT_CLICK)

{

Print("Нажатие кнопки мышки на объекте с именем '"+sparam+"'");

}

//--- нажатие кнопки на клавиатуре

if(id==CHARTEVENT_KEYDOWN)

{

switch(lparam)

{

case KEY_NUMLOCK_LEFT: Print("Нажата KEY_NUMLOCK_LEFT"); break;

case KEY_LEFT: Print("Нажата KEY_LEFT"); break;

case KEY_NUMLOCK_UP: Print("Нажата KEY_NUMLOCK_UP"); break;

case KEY_UP: Print("Нажата KEY_UP"); break;

case KEY_NUMLOCK_RIGHT: Print("Нажата KEY_NUMLOCK_RIGHT"); break;

case KEY_RIGHT: Print("Нажата KEY_RIGHT"); break;

case KEY_NUMLOCK_DOWN: Print("Нажата KEY_NUMLOCK_DOWN"); break;

case KEY_DOWN: Print("Нажата KEY_DOWN"); break;

case KEY_NUMPAD_5: Print("Нажата KEY_NUMPAD_5"); break;

case KEY_NUMLOCK_5: Print("Нажата KEY_NUMLOCK_5"); break;

default: Print("Нажата какая-то неперечисленная клавиша");

}

ChartRedraw();

}

//--- удален объекта

if(id==CHARTEVENT_OBJECT_DELETE)

{

Стандартные константы, перечисления и структуры

192

Print("Удален объект с именем ",sparam);

}

//--- создан объект

if(id==CHARTEVENT_OBJECT_CREATE)

{

Print("Создан объект с именем ",sparam);

}

//--- перемещен объект или изменены координаты точек привязки

if(id==CHARTEVENT_OBJECT_DRAG)

{

Print("Изменение точек привязки объекта с именем ",sparam);

}

//--- изменен текст в поле ввода графического объекта Edit

if(id==CHARTEVENT_OBJECT_ENDEDIT)

{

Print("Изменен текст в объекте Edit ",sparam);

}

Смотри также

Функции обработки событий, Работа с событиями

Стандартные константы, перечисления и структуры

193

Периоды графиков

Все предопределенные периоды графиков имеют уникальные идентификаторы. Идентификатор

PERIOD_CURRENT означает текущий период графика, на котором запущена mql5-программа.

ENUM_TIMEFRAMES

Идентификатор

Описание

PERIOD_CURRENT

Текущий период

PERIOD_M1

1 минута

PERIOD_M2

2 минуты

PERIOD_M3

3 минуты

PERIOD_M4

4 минуты

PERIOD_M5

5 минут

PERIOD_M6

6 минут

PERIOD_M10

10 минут

PERIOD_M12

12 минут

PERIOD_M15

15 минут

PERIOD_M20

20 минут

PERIOD_M30

30 минут

PERIOD_H1

1 час

PERIOD_H2

2 часа

PERIOD_H3

3 часа

PERIOD_H4

4 часа

PERIOD_H6

6 часов

PERIOD_H8

8 часов

PERIOD_H12

12 часов

PERIOD_D1

1 день

PERIOD_W1

1 неделя

PERIOD_MN1

1 месяц

Пример:

Стандартные константы, перечисления и структуры

194

string chart_name="test_Object_Chart";

Print("Попробуем создать объект Chart с именем ",chart_name);

//--- если такого объекта нет - создадим его

if(ObjectFind(0,chart_name)<0)ObjectCreate(0,chart_name,OBJ_CHART,0,0,0,0,0);

//--- зададим символ

ObjectSetString(0,chart_name,OBJPROP_SYMBOL,"EURUSD");

//--- зададим координату X для точки привязки

ObjectSetInteger(0,chart_name,OBJPROP_XDISTANCE,100);

//--- зададим координату Y для точки привязки

ObjectSetInteger(0,chart_name,OBJPROP_YDISTANCE,100);

//--- установим ширину

ObjectSetInteger(0,chart_name,OBJPROP_XSIZE,400);

//--- установим высоту

ObjectSetInteger(0,chart_name,OBJPROP_YSIZE,300);

//--- установим период

ObjectSetInteger(0,chart_name,OBJPROP_PERIOD,PERIOD_D1);

//--- установим масшаб ( от 0 до 5)

ObjectSetInteger(0,chart_name,OBJPROP_SCALE,4);

//--- сделаем недоступным для выделения мышкой

ObjectSetInteger(0,chart_name,OBJPROP_SELECTABLE,false);

Смотри также

PeriodSeconds, Period, Дата и время, Видимость объектов

Стандартные константы, перечисления и структуры

195

Свойства графиков

Идентификаторы семейства перечислений ENUM_CHART_PROPERTY используются в качестве

параметров функцийдляработысграфиками. Аббревиатура r/o в столбце "Тип свойства"

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

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

модификатор (modifier), который служит для указания номера подокна графика. 0 означает

главное окно.

Для функций ChartSetInteger() и ChartGetInteger()

ENUM_CHART_PROPERTY_INTEGER

Идентификатор

Описание

Тип свойства

CHART_BRING_TO_TOP

Показ графика поверх всех

других

bool

CHART_EVENT_OBJECT_CREAT

Отправка всем mql5-

программам на графике

сообщений о событии

создания графического

объекта (

CHARTEVENT_OBJECT_CREAT

bool

CHART_EVENT_OBJECT_DELET

Отправка всем mql5-

программам на графике

сообщений о событии

уничтожения графического

объекта (

CHARTEVENT_OBJECT_DELETE

)

bool

CHART_MODE

Тип графика (свечи, бары

или линия)

enum ENUM_CHART_MODE

CHART_FOREGROUND

Ценовой график на заднем

плане

bool

CHART_SHIFT

Режим отступа ценового

графика от правого края

bool

CHART_AUTOSCROLL

Режим автоматического

перехода к правому краю

графика

bool

CHART_SCALE

Масштаб

int от 0 до 5

CHART_SCALEFIX

Режим фиксированного

масштаба

bool

CHART_SCALEFIX_11

Режим масштаба 1:1

bool

CHART_SCALE_PT_PER_BAR

Режим указания масштаба в

bool

Стандартные константы, перечисления и структуры

196

пунктах на бар

CHART_SHOW_OHLC

Отображение в левом

верхнем углу значений OHLC

bool

CHART_SHOW_BID_LINE

Отображение значения Bid

горизонтальной линией на

графике

bool

CHART_SHOW_ASK_LINE

Отображение значения Ask

горизонтальной линией на

графике

bool

CHART_SHOW_LAST_LINE

Отображение значения Last

горизонтальной линией на

графике

bool

CHART_SHOW_PERIOD_SEP

Отображение вертикальных

разделителей между

соседними периодами

bool

CHART_SHOW_GRID

Отображение сетки на

графике

bool

CHART_SHOW_VOLUMES

Отображение объемов на

графике

enum

ENUM_CHART_VOLUME_MODE

CHART_SHOW_OBJECT_DESCR

Всплывающие описания

графических объектов

bool

CHART_VISIBLE_BARS

Количество баров на

графике, доступных для

отображения

int r/o

CHART_WINDOWS_TOTAL

Общее количество окон

графика, включая подокна

индикаторов

int r/o

CHART_WINDOW_IS_VISIBLE

Видимость подокон

bool r/o модификатор -

номер подокна

CHART_WINDOW_HANDLE

Хэндл графика (HWND)

int r/o

CHART_FIRST_VISIBLE_BAR

Номер первого видимого

бара на графике.

Индексация баров

соответствует таймсерии.

int r/o

CHART_WIDTH_IN_BARS

Ширина графика в барах

int r/o

CHART_WIDTH_IN_PIXELS

Ширина графика в пикселях

int r/o

CHART_HEIGHT_IN_PIXELS

Высота графика в пикселях

int r/o модификатор -

номер подокна

CHART_COLOR_BACKGROUND

Цвет фона графика

color

CHART_COLOR_FOREGROUND

Цвет осей, шкалы и строки

color

Стандартные константы, перечисления и структуры

197

OHLC

CHART_COLOR_GRID

Цвет сетки

color

CHART_COLOR_VOLUME

Цвет объемов и уровней

открытия позиций

color

CHART_COLOR_CHART_UP

Цвет бара вверх, тени и

окантовки тела бычьей свечи

color

CHART_COLOR_CHART_DOWN

Цвет бара вниз, тени и

окантовки тела медвежьей

свечи

color

CHART_COLOR_CHART_LINE

Цвет линии графика и

японских свечей "Доджи"

color

CHART_COLOR_CANDLE_BULL

Цвет тела бычьей свечи

color

CHART_COLOR_CANDLE_BEAR

Цвет тела медвежьей свечи

color

CHART_COLOR_BID

Цвет линии Bid-цены

color

CHART_COLOR_ASK

Цвет линии Ask-цены

color

CHART_COLOR_LAST

Цвет линии цены последней

совершенной сделки (Last)

color

CHART_COLOR_STOP_LEVEL

Цвет уровней стоп-ордеров

(Stop Loss и Take Profit)

color

CHART_SHOW_TRADE_LEVELS

Отображение на графике

торговых уровней (уровни

открытых позиций, Stop Loss,

Take Profit и отложенных

ордеров)

bool

CHART_SHOW_DATE_SCALE

Отображение на графике

шкалы времени

bool

CHART_SHOW_PRICE_SCALE

Отображение на графике

ценовой шкалы

bool

Для функций ChartSetDouble() и ChartGetDouble()

ENUM_CHART_PROPERTY_DOUBLE

Идентификатор

Описание

Тип свойства

CHART_SHIFT_SIZE

Размер отступа нулевого

бара от правого края в

процентах

double (от 10 до 50

процентов)

CHART_FIXED_MAX

Фиксированный максимум

графика

double

CHART_FIXED_MIN

Фиксированный минимум

графика

double

Стандартные константы, перечисления и структуры

198

CHART_POINTS_PER_BAR

Значение масштаба в пунктах

на бар

double

CHART_PRICE_MIN

Минимум графика

double r/o модификатор -

номер подокна

CHART_PRICE_MAX

Максимум графика

double r/o модификатор -

номер подокна

Для функций ChartSetString() и ChartGetString()

ENUM_CHART_PROPERTY_STRING

Идентификатор

Описание

Тип свойства

CHART_COMMENT

Текст комментария на

графике

string

Пример:

int chartMode=ChartGetInteger(0,CHART_MODE);

switch(chartMode)

{

case(CHART_BARS): Print("CHART_BARS"); break;

case(CHART_CANDLES): Print("CHART_CANDLES");break;

default:Print("CHART_LINE");

}

bool shifted=ChartGetInteger(0,CHART_SHIFT);

if(shifted) Print("CHART_SHIFT = true");

else Print("CHART_SHIFT = false");

bool autoscroll=ChartGetInteger(0,CHART_AUTOSCROLL);

if(autoscroll) Print("CHART_AUTOSCROLL = true");

else Print("CHART_AUTOSCROLL = false");

int chartHandle=ChartGetInteger(0,CHART_WINDOW_HANDLE);

Print("CHART_WINDOW_HANDLE = ",chartHandle);

int windows=ChartGetInteger(0,CHART_WINDOWS_TOTAL);

Print("CHART_WINDOWS_TOTAL = ",windows);

if(windows>1)

{

for(int i=0;i<windows;i++)

{

int height=ChartGetInteger(0,CHART_HEIGHT_IN_PIXELS,i);

double priceMin=ChartGetDouble(0,CHART_PRICE_MIN,i);

double priceMax=ChartGetDouble(0,CHART_PRICE_MAX,i);

Print(i+": CHART_HEIGHT_IN_PIXELS = ",height,"pixels");

Print(i+": CHART_PRICE_MIN = ",priceMin);

Print(i+": CHART_PRICE_MAX = ",priceMax);

}

Стандартные константы, перечисления и структуры

199

Позиционирование графика

Три идентификатора из списка ENUM_CHART_POSITION являются возможными значениями

параметра position для функции ChartNavigate().

ENUM_CHART_POSITION

Идентификатор

Описание

CHART_BEGIN

Начало графика (самые старые цены)

CHART_CURRENT_POS

Текущая позиция

CHART_END

Конец графика (самые свежие цены)

Пример:

long handle=ChartOpen("EURUSD",PERIOD_H12);

if(handle!=0)

{

ChartSetInteger(handle,CHART_AUTOSCROLL,false);

ChartSetInteger(handle,CHART_SHIFT,true);

ChartSetInteger(handle,CHART_MODE,CHART_LINE);

ResetLastError();

bool res=ChartNavigate(handle,CHART_END,150);

if(!res) Print("Navigate failed. Error = ",GetLastError());

ChartRedraw();

}

Стандартные константы, перечисления и структуры

200

Отображение графиков

Ценовые графики можно отображать тремя способами:

в виде баров;

в виде свечей;

в виде ломаной линии.

Конкретный способ отображения ценового графика задается функцией ChartSetInteger

(handle_графика,CHART_MODE, тип_графика), где тип_графика – одно из значений перечисления

ENUM_CHART_MODE.

ENUM_CHART_MODE

Идентификатор

Описание

CHART_BARS

Отображение в виде баров

CHART_CANDLES

Отображение в виде японских свечей

CHART_LINE

Отображение в виде линии, проведенной по

ценам Close

Для указания режима отображения объемов на ценовом графике используется функция

ChartSetInteger(handle_графика, CHART_SHOW_VOLUMES, тип_отображения), где

тип_отображения – одно из значений перечисления ENUM_CHART_VOLUME_MODE.

ENUM_CHART_VOLUME_MODE

Идентификатор

Описание

CHART_VOLUME_HIDE

Объемы не показаны

CHART_VOLUME_TICK

Тиковые объемы

CHART_VOLUME_REAL

Торговые объемы

Пример:

//--- получим handle текущего графика

long handle=ChartID();

if(handle>0) // если получилось, дополнительно настроим

{

//--- отключим автопрокрутку

ChartSetInteger(handle,CHART_AUTOSCROLL,false);

//--- установим отступ правого края графика

ChartSetInteger(handle,CHART_SHIFT,true);

//--- отобразим в виде свечей

ChartSetInteger(handle,CHART_MODE,CHART_CANDLES);

//--- прокрутим на 100 баров от начала истории

ChartNavigate(handle,CHART_CURRENT_POS,100);

//--- установить режим отображения тиковых объемов

ChartSetInteger(handle,CHART_SHOW_VOLUMES,CHART_VOLUME_TICK);