Справочник по языку программирования MQL5
Подождите немного. Документ загружается.
Стандартные константы, перечисления и структуры
© 2000-2011, MetaQuotes Software Corp.
201
}
Смотри также
ChartOpen, ChartID
Стандартные константы, перечисления и структуры
© 2000-2011, MetaQuotes Software Corp.
202
Константы объектов
Предусмотрено 39 графических объектов, которые можно создавать и отображать на ценовом
графике. Все константы для работы с объектами разбиты на 9 групп:
Типыобъектов – идентификаторы графических объектов;
Свойстваобъектов – работа со свойствами графических объектов;
Способыпривязкиобъектов – константы позиционирования объектов на графике;
Угол привязки – позволяет установить угла графика, относительно которого производится
позиционирование объекта в пикселях;
Видимостьобъектов – задание таймфреймов, на которых объект является видимым;
УровниволнЭллиотта – градация волновой разметки;
ОбъектыГанна – константы тренда для веера Ганна и сетки Ганна;
НаборWeb-цветов – константы предопределенных Web-цветов;
Wingdings – коды символов шрифта Wingdings.
Стандартные константы, перечисления и структуры
© 2000-2011, MetaQuotes Software Corp.
203
Типы объектов
При создании графического объекта функцией ObjectCreate() необходимо указать тип
создаваемого объекта, который может принимать одно из значений перечисления ENUM_OBJECT.
Дальнейшие уточнения свойств созданного объекта возможно с помощью функций по работе с
графическимиобъектами.
ENUM_OBJECT
Идентификатор
Описание
OBJ_VLINE
Вертикальная линия
OBJ_HLINE
Горизонтальная линия
OBJ_TREND
Трендовая линия
OBJ_TRENDBYANGLE
Трендовая линия по углу
OBJ_CHANNEL
Равноудаленный канал
OBJ_STDDEVCHANNEL
Канал стандартного
отклонения
OBJ_REGRESSION
Канал на линейной регрессии
OBJ_PITCHFORK
Вилы Эндрюса
OBJ_GANNLINE
Линия Ганна
OBJ_GANNFAN
Веер Ганна
OBJ_GANNGRID
Сетка Ганна
OBJ_FIBO
Уровни Фибоначчи
OBJ_FIBOTIMES
Временные зоны Фибоначчи
OBJ_FIBOFAN
Веер Фибоначчи
OBJ_FIBOARC
Дуги Фибоначчи
OBJ_FIBOCHANNEL
Канал Фибоначчи
OBJ_EXPANSION
Расширение Фибоначчи
OBJ_ELLIOTWAVE5
5-волновка Эллиота
OBJ_ELLIOTWAVE3
3-волновка Эллиота
OBJ_RECTANGLE
Прямоугольник
OBJ_TRIANGLE
Треугольник
OBJ_ELLIPSE
Эллипс
OBJ_CYCLES
Циклические линии
OBJ_ARROW_THUMB_UP
Знак "Хорошо" (большой
палец вверх)
OBJ_ARROW_THUMB_DOWN
Знак "Плохо" (большой палец
Стандартные константы, перечисления и структуры
© 2000-2011, MetaQuotes Software Corp.
204
вниз)
OBJ_ARROW_UP
Знак "Стрелка вверх"
OBJ_ARROW_DOWN
Знак "Стрелка вниз"
OBJ_ARROW_STOP
Знак "Стоп"
OBJ_ARROW_CHECK
Знак "Птичка" (галка)
OBJ_ARROW_LEFT_PRICE
Левая ценовая метка
OBJ_ARROW_RIGHT_PRICE
Правая ценовая метка
OBJ_ARROW_BUY
Знак "Buy"
OBJ_ARROW_SELL
Знак "Sell"
OBJ_ARROW
Объект "Стрелка"
OBJ_TEXT
Объект "Текст"
OBJ_LABEL
Объект "Текстовая метка"
OBJ_BUTTON
Объект "Кнопка"
OBJ_CHART
Объект "График"
OBJ_BITMAP
Объект "Рисунок"
OBJ_BITMAP_LABEL
Объект "Графическая метка"
OBJ_EDIT
Объект "Поле ввода"
OBJ_ARROWED_LINE
Объект "Линия со стрелкой"
OBJ_EVENT
Объект "Событие",
соответствующий событию в
экономическом календаре
OBJ_RECTANGLE_LABEL
Объект "Прямоугольная
метка"для создания и
оформления
пользовательского
графического интерфейса.
Стандартные константы, перечисления и структуры
© 2000-2011, MetaQuotes Software Corp.
205
Свойства объектов
Каждый графический объект на графике цен имеет некоторый набор свойств. Установка и
получение значений свойств объектов производится соответствующими
функциямипоработесграфическимиобъектами. Для каждого типаобъекта есть свой набор
свойств, здесь перечислены все возможные значения из семейства перечислений
ENUM_OBJECT_PROPERTY. Некоторые свойства требуют уточнения, как например, номер уровня
для объекта расширения Фибоначчи. В таких случаях необходимо в функциях ObjectSet...() и
ObjectGet...() указывать значение параметра modifier.
Для функций ObjectSetInteger() и ObjectGetInteger()
ENUM_OBJECT_PROPERTY_INTEGER
Идентификатор
Описание
Тип свойства
OBJPROP_COLOR
Цвет
color
OBJPROP_STYLE
Стиль
ENUM_LINE_STYLE
OBJPROP_WIDTH
Толщина линии
int
OBJPROP_BACK
Объект на заднем плане
bool
OBJPROP_FILL
Заливка объекта цветом (для
OBJ_RECTANGLE,
OBJ_TRIANGLE, OBJ_ELLIPSE,
OBJ_CHANNEL,
OBJ_STDDEVCHANNEL,
OBJ_REGRESSION)
bool
OBJPROP_SELECTED
Выделенность объекта
bool
OBJPROP_READONLY
Возможность редактирования
текста в объекте Edit
bool
OBJPROP_TYPE
Тип объекта
ENUM_OBJECT
OBJPROP_TIME
Координата времени
datetime
модификатор=номер точки
привязки
OBJPROP_SELECTABLE
Доступность объекта
bool
OBJPROP_CREATETIME
Время создания объекта
datetime r/o
OBJPROP_LEVELS
Количество уровней
int
OBJPROP_LEVELCOLOR
Цвет линии-уровня
color модификатор=номер
уровня
OBJPROP_LEVELSTYLE
Стиль линии-уровня
ENUM_LINE_STYLE
модификатор=номер уровня
OBJPROP_LEVELWIDTH
Толщина линии-уровня
int модификатор=номер
уровня
OBJPROP_FONTSIZE
Размер шрифта
int
Стандартные константы, перечисления и структуры
© 2000-2011, MetaQuotes Software Corp.
206
OBJPROP_RAY_LEFT
Луч продолжается влево
bool
OBJPROP_RAY_RIGHT
Луч продолжается вправо
bool
OBJPROP_RAY
Вертикальная линия
продолжается на все окна
графика
bool
OBJPROP_ELLIPSE
Отображение полного
эллипса для объекта "Дуги
Фибоначчи" (OBJ_FIBOARC)
bool
OBJPROP_ARROWCODE
Код стрелки для объекта
"Стрелка"
char
OBJPROP_TIMEFRAMES
Видимость объекта на
таймфреймах
набор флагов flags
OBJPROP_ANCHOR
Положение точки привязки
графического объекта
ENUM_ARROW_ANCHOR (для
OBJ_ARROW),
ENUM_ANCHORPOINT (для
OBJ_LABEL и OBJ_TEXT)
OBJPROP_XDISTANCE
Дистанция в пикселях по оси
X от угла привязки
int
OBJPROP_YDISTANCE
Дистанция в пикселях по оси
Y от угла привязки
int
OBJPROP_DIRECTION
Тренд объекта Ганна
ENUM_GANN_DIRECTION
OBJPROP_DEGREE
Уровень волновой разметки
Эллиота
ENUM_ELLIOT_WAVE_DEGREE
OBJPROP_DRAWLINES
Отображение линий для
волновой разметки Эллиота
bool
OBJPROP_STATE
Состояние кнопки (Нажата/
Отжата)
bool
OBJPROP_CHART_ID
Идентификатор объекта
"График" (OBJ_CHART).
Позволяет работать со
свойствами этого объекта
как с обычным графиком с
помощью функций из раздела
Операции с графиками, но
есть некоторые исключения.
long
OBJPROP_XSIZE
Размер объекта "График" по
оси X (ширина в пикселях)
int
OBJPROP_YSIZE
Размер объекта "График" по
оси Y (высота в пикселях)
int
OBJPROP_XOFFSET
X-координата левого
верхнего угла прямоугольной
области видимости в
int
Стандартные константы, перечисления и структуры
© 2000-2011, MetaQuotes Software Corp.
207
графических объектах
"Графическая метка" и
"Рисунок"
(OBJ_BITMAP_LABEL и
OBJ_BITMAP). Значение
задается в пикселях
относительного верхнего
левого угла исходного
изображения.
OBJPROP_YOFFSET
X-координата левого
верхнего угла прямоугольной
области видимости в
графических объектах
"Графическая метка" и
"Рисунок"
(OBJ_BITMAP_LABEL и
OBJ_BITMAP). Значение
задается в пикселях
относительного верхнего
левого угла исходного
изображения.
int
OBJPROP_PERIOD
Период для объекта
"График"
ENUM_TIMEFRAMES
OBJPROP_DATE_SCALE
Признак отображения шкалы
времени для объекта
"График"
bool
OBJPROP_PRICE_SCALE
Признак отображения
ценовой шкалы для объекта
"График"
bool
OBJPROP_CHART_SCALE
Масштаб для объекта
"График"
int значение в диапазоне 0–5
OBJPROP_BGCOLOR
Цвет фона для OBJ_EDIT,
OBJ_BUTTON,
OBJ_RECTANGLE_LABEL
color
OBJPROP_CORNER
Угол графика для привязки
графического объекта
ENUM_BASECORNER
OBJPROP_BORDER_TYPE
Тип рамки для объекта
"Прямоугольная рамка"
ENUM_BORDER_TYPE
При применении операций с графиками для объекта "График" (OBJ_CHART) действуют следующие
ограничения:
нельзя закрыть с помощью ChartClose();
нельзя поменять символ/период с помощью функции ChartSetSymbolPeriod();
не работают свойства CHART_SCALE, CHART_BRING_TO_TOP, CHART_SHOW_DATE_SCALE и
CHART_SHOW_PRICE_SCALE (ENUM_CHART_PROPERTY_INTEGER).
Стандартные константы, перечисления и структуры
© 2000-2011, MetaQuotes Software Corp.
208
Для объектов OBJ_BITMAP_LABEL и OBJ_BITMAP программным путем можно установить
специальный режим показа изображения. В этом режиме показывается только та часть исходного
изображения, на которую накладывается прямоугольная область видимости, остальная часть
картинки становится невидимой. Размеры области видимости необходимо установить с помощью
свойств OBJPROP_XSIZE и OBJPROP_YSIZE. Область видимости можно "перемещать" только в
пределах исходного изображения с помощью свойств OBJPROP_XOFFSET и OBJPROP_YOFFSET.
Для функций ObjectSetDouble() и ObjectGetDouble()
ENUM_OBJECT_PROPERTY_DOUBLE
Идентификатор
Описание
Тип свойства
OBJPROP_PRICE
Координата цены
double модификатор=номер
точки привязки
OBJPROP_LEVELVALUE
Значение уровня
double модификатор=номер
уровня
OBJPROP_SCALE
Масштаб (свойство объектов
Ганна и объекта "Дуги
Фибоначчи")
double
OBJPROP_ANGLE
Угол
double
OBJPROP_DEVIATION
Отклонение для канала
стандартного отклонения
double
Для функций ObjectSetString() и ObjectGetString()
ENUM_OBJECT_PROPERTY_STRING
Идентификатор
Описание
Тип свойства
OBJPROP_NAME
Имя объекта
string
OBJPROP_TEXT
Описание объекта (текст,
содержащийся в объекте)
string
OBJPROP_TOOLTIP
Текст всплывающей
подсказки. Если свойство не
задано, то показывается
подсказка, автоматически
сформированная
терминалом. Можно
отключить показ подсказки,
установив для нее значение
"\n" (перевод строки)
string
OBJPROP_LEVELTEXT
Описание уровня
string модификатор=номер
Стандартные константы, перечисления и структуры
© 2000-2011, MetaQuotes Software Corp.
209
уровня
OBJPROP_FONT
Шрифт
string
OBJPROP_BMPFILE
Имя BMP-файла для объекта
"Графическая метка".
Смотри также Ресурсы
string модификатор: 0-
состояние ON, 1-состояние
OFF
OBJPROP_SYMBOL
Символ для объекта
"График"
string
Для объекта OBJ_RECTANGLE_LABEL ("Прямоугольная метка") можно задать один из трех видов
отображения, которым соответствуют значения из перечисления ENUM_BORDER_TYPE.
ENUM_BORDER_TYPE
Идентификатор
Описание
BORDER_FLAT
Плоский вид
BORDER_RAISED
Выпуклый вид
BORDER_SUNKEN
Вогнутый вид
Пример:
Стандартные константы, перечисления и структуры
© 2000-2011, MetaQuotes Software Corp.
210
#define UP "\x0431"
//+------------------------------------------------------------------+
//| Script program start function |
//+------------------------------------------------------------------+
void OnStart()
{
//---
string label_name="my_OBJ_LABEL_object";
if(ObjectFind(0,label_name)<0)
{
Print("Object ",label_name," not found. Error code = ",GetLastError());
//--- создадим объект Label
ObjectCreate(0,label_name,OBJ_LABEL,0,0,0);
//--- установим координату X
ObjectSetInteger(0,label_name,OBJPROP_XDISTANCE,200);
//--- установим координату Y
ObjectSetInteger(0,label_name,OBJPROP_YDISTANCE,300);
//--- зададим цвет текста
ObjectSetInteger(0,label_name,OBJPROP_COLOR,clrWhite);
//--- установим текст для объекта Label
ObjectSetString(0,label_name,OBJPROP_TEXT,UP);
//--- установим шрифт надписи
ObjectSetString(0,label_name,OBJPROP_FONT,"Wingdings");
//--- установим размер шрифта
ObjectSetInteger(0,label_name,OBJPROP_FONTSIZE,10);
//--- повернем на 45 градусов по часовой стрелке
ObjectSetDouble(0,label_name,OBJPROP_ANGLE,-45);
//--- запретим выделение объекта мышкой
ObjectSetInteger(0,label_name,OBJPROP_SELECTABLE,false);
//--- отрисуем на графике
ChartRedraw(0);
}
}