Константы объектов

Предусмотрено 44 графических объекта, которые можно создавать и отображать на ценовом графике. Все константы для работы с объектами разбиты на 9 групп:

• Типы объектов – идентификаторы графических объектов;
• Свойства объектов – работа со свойствами графических объектов;
• Способы привязки объектов – константы позиционирования объектов на графике;
• Угол привязки – позволяет установить угла графика, относительно которого  производится позиционирование объекта в пикселях;
• Видимость объектов – задание таймфреймов, на которых объект является видимым;
• Уровни волн Эллиотта – градация волновой разметки;
• Объекты Ганна – константы тренда для веера Ганна и сетки Ганна;
• Набор Web-цветов – константы предопределенных Web-цветов;
• Wingdings – коды символов шрифта Wingdings.

Типы объектов

При создании графического объекта функцией ObjectCreate() необходимо указать тип создаваемого объекта, который может принимать одно из значений перечисления ENUM_OBJECT. Дальнейшие уточнения свойств созданного объекта возможно с помощью функций по работе с графическими объектами.

ENUM_OBJECT

Свойства объектов

Графические объекты могут иметь множество свойств в зависимости от типа объекта. Установка и получение значений свойств объектов производится соответствующими функциями по работе с графическими объектами.

Все объекты, используемые в техническом анализе, имеют привязку на графиках по координатам цены и времени – трендовая линия, каналы, инструменты Фибоначчи и т.д.  Но есть ряд вспомогательных объектов, предназначенных для улучшения интерфейса, которые имеют привязку к видимой всегда части графика (основное окно графика или подокна индикаторов):

В таблице использованы следующие обозначения:

• X/Y – координаты точки привязки задаются в пикселях относительно одного из углов графика;
• Width/Height – объекты имеет ширину и высоту. Если указано «только для чтения», то это означает, что значения ширины и высоты вычисляются только после отрисовки объекта на графике;
• Date/Price – координаты точки привязки задаются парой дата/цена;
• OBJPROP_CORNER – задаёт угол графика, относительно которого указываются координаты точки привязки. Может быть одним из 4-х значений перечисления ENUM_BASE_CORNER;
• OBJPROP_ANCHOR – задаёт положение точки привязки в самом объекте, и может быть одним из 9-ти значений перечисления ENUM_ANCHOR_POINT. Именно от этой точки до выбранного угла графика указываются координаты в пикселях;
• OBJPROP_ANGLE – задаёт угол поворота объекта против часовой стрелки.

Функции, задающие свойства графических объектов, а также операции создания ObjectCreate() и перемещения ObjectMove() объектов на графике фактически служат для отправки команд графику. При успешном выполнении этих функций команда попадает в общую очередь событий графика. Визуальное изменение свойств графических объектов производится в процессе обработки очереди событий данного графика.

По этой причине не следует ожидать немедленного визуального обновления графических объектов после вызова данных функций. В общем случае обновление графических объектов на чарте производится терминалом автоматически по событиям изменения — поступление новой котировки, изменения размера окна графика и т.д. Для принудительного обновления графических объектов используйте команду на перерисовку графика ChartRedraw().

Для функций ObjectSetInteger() и ObjectGetInteger()

ENUM_OBJECT_PROPERTY_INTEGER

При применении операций с графиками для объекта «График»  (OBJ_CHART) действуют следующие ограничения:

• нельзя закрыть с помощью ChartClose();
• нельзя поменять символ/период с помощью функции ChartSetSymbolPeriod();
• не работают свойства CHART_SCALE, CHART_BRING_TO_TOP, CHART_SHOW_DATE_SCALE и CHART_SHOW_PRICE_SCALE (ENUM_CHART_PROPERTY_INTEGER).

 

Для объектов OBJ_BITMAP_LABEL и OBJ_BITMAP программным путем можно установить специальный режим показа изображения. В этом режиме показывается только та часть исходного изображения, на которую накладывается прямоугольная область видимости, остальная часть картинки становится невидимой. Размеры области видимости необходимо установить с помощью свойств OBJPROP_XSIZE и OBJPROP_YSIZE. Область видимости можно «перемещать» только в пределах исходного изображения с помощью  свойств OBJPROP_XOFFSET и OBJPROP_YOFFSET.

 

Для объектов с фиксированными размерами: OBJ_BUTTON, OBJ_RECTANGLE_LABEL, OBJ_EDIT и OBJ_CHART свойства OBJPROP_XDISTANCE и OBJPROP_YDISTANCE задают положение левой верхней точки объекта относительно угла графика (OBJPROP_CORNER), от которого будут отсчитываться координаты X и Y в пикселях.

 

Для функций ObjectSetDouble() и ObjectGetDouble()

ENUM_OBJECT_PROPERTY_DOUBLE

 

Для функций ObjectSetString() и ObjectGetString()

ENUM_OBJECT_PROPERTY_STRING

 

Для объекта OBJ_RECTANGLE_LABEL («Прямоугольная метка») можно задать один из трех видов отображения, которым соответствуют значения из перечисления ENUM_BORDER_TYPE.

ENUM_BORDER_TYPE

 

Для объекта OBJ_EDIT («Поле ввода») и для функции ChartScreenShot() можно указать тип выравнивания по горизонтали с помощью значений перечисления ENUM_ALIGN_MODE.

ENUM_ALIGN_MODE

Пример:

#define UP "\x0431"
//+------------------------------------------------------------------+
//| Script program start function | //+------------------------------------------------------------------+
void OnStart()
{
   //---
   string label_name="my_OBJ_LABEL_object";
   if(ObjectFind(0,label_name)
 
 
Способы привязки объектов
 
Графические объекты Text, Label, Bitmap и Bitmap Label (OBJ_TEXT, OBJ_LABEL, OBJ_BITMAP и OBJ_BITMAP_LABEL) могут иметь один из 9 различных способов привязки своих координат, задаваемых свойством OBJPROP_ANCHOR. 
 
 
 
 
 
 
Объект
 
 
 
Идентификатор
 
 
 
X/Y
 
 
 
Width/Height
 
 
 
Date/Price
 
 
 
OBJPROP_CORNER
 
 
 
OBJPROP_ANCHOR
 
 
 
OBJPROP_ANGLE
 
 
 
 
 
Text
 
 
 
OBJ_TEXT
 
 
 
—
 
 
 
—
 
 
 
Да
 
 
 
—
 
 
 
Да
 
 
 
Да
 
 
 
 
 
Label
 
 
 
OBJ_LABEL
 
 
 
Да
 
 
 
Да (только для чтения)
 
 
 
—
 
 
 
Да
 
 
 
Да
 
 
 
Да
 
 
 
 
 
Button
 
 
 
OBJ_BUTTON
 
 
 
Да
 
 
 
Да
 
 
 
—
 
 
 
Да
 
 
 
—
 
 
 
—
 
 
 
 
 
Bitmap
 
 
 
OBJ_BITMAP
 
 
 
—
 
 
 
Да (только для чтения)
 
 
 
Да
 
 
 
—
 
 
 
Да
 
 
 
—
 
 
 
 
 
Bitmap Label
 
 
 
OBJ_BITMAP_LABEL
 
 
 
Да
 
 
 
Да (только для чтения)
 
 
 
—
 
 
 
Да
 
 
 
Да
 
 
 
—
 
 
 
 
 
Edit
 
 
 
OBJ_EDIT
 
 
 
Да
 
 
 
Да
 
 
 
—
 
 
 
Да
 
 
 
—
 
 
 
—
 
 
 
 
 
Rectangle Label
 
 
 
OBJ_RECTANGLE_LABEL
 
 
 
Да
 
 
 
Да
 
 
 
—
 
 
 
Да
 
 
 
—
 
 
 
—
 
 
 
 
 
 
В таблице использованы следующие обозначения:
 

• X/Y – координаты точки привязки задаются в пикселях относительно одного из углов графика;
• Width/Height – объекты имеет ширину и высоту. Если указано «только для чтения», то это означает, что значения ширины и высоты вычисляются только после отрисовки объекта на графике;
• Date/Price – координаты точки привязки задаются парой дата/цена;
• OBJPROP_CORNER – задаёт угол графика, относительно которого указываются координаты точки привязки. Может быть одним из 4-х значений перечисления ENUM_BASE_CORNER;
• OBJPROP_ANCHOR – задаёт положение точки привязки в самом объекте, и может быть одним из 9-ти значений перечисления ENUM_ANCHOR_POINT. Именно от этой точки до выбранного угла графика указываются координаты в пикселях;
• OBJPROP_ANGLE – задаёт угол поворота объекта против часовой стрелки.

Указать нужный вариант можно с помощью функции ObjectSetInteger(handle_графика, имя_объекта, OBJPROP_ANCHOR, способ_привязки), где способ_привязки — одно из значений перечисления ENUM_ANCHOR_POINT.

ENUM_ANCHOR_POINT

Объекты OBJ_BUTTON, OBJ_RECTANGLE_LABEL, OBJ_EDIT и OBJ_CHART имеют фиксированную точку привязки в левом верхнем углу (ANCHOR_LEFT_UPPER).

Пример:

 string text_name="my_OBJ_TEXT_object";
 if(ObjectFind(0,text_name)
Графические объекты Arrow (OBJ_ARROW) имеют только 2 способа привязки своих координат. Идентификаторы перечислены в ENUM_ARROW_ANCHOR.
 
ENUM_ARROW_ANCHOR
 
 
 
 
 
 
Идентификатор
 
 
 
Описание
 
 
 
 
 
ANCHOR_TOP
 
 
 
Точка привязки для стрелки находится сверху
 
 
 
 
 
ANCHOR_BOTTOM
 
 
 
Точка привязки для стрелки находится внизу
 
 
 
 
 
 
Пример:
 
void OnStart()
{
   //--- служебные массивы
   double Ups[],Downs[];
   datetime Time[];

   //--- установим для массивов признак таймсерии
   ArraySetAsSeries(Ups,true);
   ArraySetAsSeries(Downs,true);
   ArraySetAsSeries(Time,true);

   //--- создадим хэндл индикатора Fractals
   int FractalsHandle=iFractals(NULL,0);
   Print("FractalsHandle = ",FractalsHandle);

   //--- сбросим код ошибки
   ResetLastError();

   //--- попытаемся скопировать значения индикатора
   int copied=CopyBuffer(FractalsHandle,0,0,1000,Ups);
   if(copied
После выполнения скрипта график будет выглядеть примерно как на этом рисунке.
 
 
Угол графика, к которому привязан объект
 
Существует ряд графических объектов, для которых можно задавать угол графика, относительно которого указываются координаты в пикселях. Это следующие типы объектов (в скобках указаны идентификаторы типа объекта): 
 

• Label (OBJ_LABEL); Текстовая метка
• Button (OBJ_BUTTON); Кнопка
• Bitmap Label (OBJ_BITMAP_LABEL); Графическая метка
• Edit (OBJ_EDIT); Поле ввода
• Rectangle Label (OBJ_RECTANGLE_LABEL). Прямоугольная метка

В таблице использованы следующие обозначения:

• X/Y – координаты точки привязки задаются в пикселях относительно одного из углов графика;
• Width/Height – объекты имеет ширину и высоту. Если указано «только для чтения», то это означает, что значения ширины и высоты вычисляются только после отрисовки объекта на графике;
• Date/Price – координаты точки привязки задаются парой дата/цена;
• OBJPROP_CORNER – задаёт угол графика, относительно которого указываются координаты точки привязки. Может быть одним из 4-х значений перечисления ENUM_BASE_CORNER;
• OBJPROP_ANCHOR – задаёт положение точки привязки в самом объекте, и может быть одним из 9-ти значений перечисления ENUM_ANCHOR_POINT. Именно от этой точки до выбранного угла графика указываются координаты в пикселях;
• OBJPROP_ANGLE – задаёт угол поворота объекта против часовой стрелки.

Для того чтобы указать угол графика, от которого будут отсчитываться координаты X и Y в пикселях, необходимо воспользоваться функцией ObjectSetInteger(chartID, name, OBJPROP_CORNER, chart_corner), где:

• chartID — идентификатор графика;
• name – имя графического объекта;
• OBJPROP_CORNER – идентификатор свойства для задания угла привязки;
• chart_corner – требуемый угол графика, может принимать одно из значений перечисления ENUM_BASE_CORNER.

ENUM_BASE_CORNER

Пример:

void CreateLabel(long chart_id,
                 string name,
                 int chart_corner,
                 int anchor_point,
                 string text_label,
                 int x_ord,
                 int y_ord)
{
    //---
    if(ObjectCreate(chart_id,name,OBJ_LABEL,0,0,0))
    {
       ObjectSetInteger(chart_id,name,OBJPROP_CORNER,chart_corner);
       ObjectSetInteger(chart_id,name,OBJPROP_ANCHOR,anchor_point);
       ObjectSetInteger(chart_id,name,OBJPROP_XDISTANCE,x_ord);
       ObjectSetInteger(chart_id,name,OBJPROP_YDISTANCE,y_ord);
       ObjectSetString(chart_id,name,OBJPROP_TEXT,text_label);
    }
    else
      Print("Не удалось создать объект OBJ_LABEL ",name,", Код ошибки = ", GetLastError());
}

//+------------------------------------------------------------------+
//| Script program start function | //+------------------------------------------------------------------+
void OnStart()
{
   //---
   int height=(int)ChartGetInteger(0,CHART_HEIGHT_IN_PIXELS,0);
   int width=(int)ChartGetInteger(0,CHART_WIDTH_IN_PIXELS,0);
   string arrows[4]={"LEFT_UPPER","RIGHT_UPPER","RIGHT_LOWER","LEFT_LOWER"};
   CreateLabel(0,arrows[0],CORNER_LEFT_UPPER,ANCHOR_LEFT_UPPER,arrows[0],50,50);
   CreateLabel(0,arrows[1],CORNER_RIGHT_UPPER,ANCHOR_RIGHT_UPPER,arrows[1],50,50);
   CreateLabel(0,arrows[2],CORNER_RIGHT_LOWER,ANCHOR_RIGHT_LOWER,arrows[2],50,50);
   CreateLabel(0,arrows[3],CORNER_LEFT_LOWER,ANCHOR_LEFT_LOWER,arrows[3],50,50);
}

Видимость объектов

Комбинация флагов видимости объекта определяет таймфреймы графика, на которых объект отображаем. Для установки/получения значения свойства OBJPROP_TIMEFRAMES можно использовать функции ObjectSetInteger()/ObjectGetInteger().

Флаги видимости можно комбинировать с помощью символа «|», например, комбинация флагов OBJ_PERIOD_M10|OBJ_PERIOD_H4 означает, что объект будет видим на 10-минутном и 4-часовом таймфреймах.

Пример:

void OnStart()
{
   //---
   string highlevel="PreviousDayHigh";
   string lowlevel="PreviousDayLow";
   double prevHigh; // High предыдущего дня
   double prevLow; // Low предыдущего дня
   double highs[],lows[]; // массивы для получения High и Low
 
   //--- сбросим значение последней ошибки
   ResetLastError();

   //--- получим 2 последних значения High на дневном таймфрейме
   int highsgot=CopyHigh(Symbol(),PERIOD_D1,0,2,highs);
   if(highsgot>0) // если копирование прошло успешно
   {
      Print("Цены High за последние 2 дня получены успешно");
      prevHigh=highs[0]; // High предыдущего дня
      Print("prevHigh = ",prevHigh);

      if(ObjectFind(0,highlevel)0) // если копирование прошло успешно
   {
      Print("Цены Low за последние 2 дня получены успешно");
      prevLow=lows[0]; // Low предыдущего дня
      Print("prevLow = ",prevLow);

      if(ObjectFind(0,lowlevel)
Уровни волн Эллиотта
 
Волны Эллиотта представлены двумя графическими объектами типов OBJ_ELLIOTWAVE5 и OBJ_ELLIOTWAVE3. Для задания размера волны (способа маркировки волн) используется свойство OBJPROP_DEGREE, которому можно установить одно из значений перечисления ENUM_ELLIOT_WAVE_DEGREE.
 
ENUM_ELLIOT_WAVE_DEGREE
 
 
 
 
 
 
Константа
 
 
 
Описание
 
 
 
 
 
ELLIOTT_GRAND_SUPERCYCLE
 
 
 
Главный Суперцикл (Grand Supercycle)
 
 
 
 
 
ELLIOTT_SUPERCYCLE
 
 
 
Суперцикл (Supercycle)
 
 
 
 
 
ELLIOTT_CYCLE
 
 
 
Цикл (Cycle)
 
 
 
 
 
ELLIOTT_PRIMARY
 
 
 
Первичный цикл (Primary)
 
 
 
 
 
ELLIOTT_INTERMEDIATE
 
 
 
Промежуточное звено (Intermediate)
 
 
 
 
 
ELLIOTT_MINOR
 
 
 
Второстепенный цикл (Minor)
 
 
 
 
 
ELLIOTT_MINUTE
 
 
 
Минута (Minute)
 
 
 
 
 
ELLIOTT_MINUETTE
 
 
 
Секунда (Minuette)
 
 
 
 
 
ELLIOTT_SUBMINUETTE
 
 
 
Субсекунда (Subminuette)
 
 
 
 
 
 
Пример:
 
for(int i=0;i 
 
 
Объекты Ганна
 
Для объектов веер Ганна (OBJ_GANNFAN) и сетка Ганна (OBJ_GANNGRID) можно указать одно из двух значений перечисления ENUM_GANN_DIRECTION, которое задает направление тренда.
 
ENUM_GANN_DIRECTION
 
 
 
 
 
 
Константа
 
 
 
Описание
 
 
 
 
 
GANN_UP_TREND
 
 
 
Линия соответствует восходящему тренду
 
 
 
 
 
GANN_DOWN_TREND
 
 
 
Линия соответствует нисходящему тренду
 
 
 
 
 
 
Для установки масштаба основной линии 1×1 используется функция ObjectSetDouble(chart_handle, gann_object_name, OBJPROP_SCALE, scale), где:
 
 
chart_handle – окно графика, в котором находится объект;
 
gann_object_name – имя объекта;
 
OBJPROP_SCALE – идентификатор свойства «Scale»;
 
scale – требуемый масштаб в единицах Pips/Bar.
 
 
 
Пример создания веера Ганна:
 
void OnStart()
{
   //---
   string my_gann="OBJ_GANNFAN object";
   if(ObjectFind(0,my_gann)
 
 
Набор Web-цветов
 
Для типа color определены следующие цветовые константы:
 
 
Задавать цвет можно для объектов с помощью функции ObjectSetInteger() и для пользовательских индикаторов с помощью функции PlotIndexSetInteger(). Для получения значения цвета служат аналогичные функции ObjectGetInteger() и PlotIndexGetInteger().
 
Пример:
 
//---- indicator settings
#property indicator_chart_window
#property indicator_buffers 3
#property indicator_plots 3
#property indicator_type1 DRAW_LINE
#property indicator_type2 DRAW_LINE
#property indicator_type3 DRAW_LINE
#property indicator_color1 clrBlue
#property indicator_color2 clrRed
#property indicator_color3 clrLime
 
Wingdings
 
Символы шрифта Wingdings, используемые с объектом OBJ_ARROW:
 
 
Установка нужного символа производится с помощью функции ObjectSetInteger().
 
Пример:
 
void OnStart()
{
   //---
   string up_arrow="up_arrow";
   datetime time=TimeCurrent();
   double lastClose[1];
   int close=CopyClose(Symbol(),Period(),0,1,lastClose); // получим цену Close

   //--- если цена получена
   if(close>0)
   {
      ObjectCreate(0,up_arrow,OBJ_ARROW,0,0,0,0,0); // создадим стрелку
      ObjectSetInteger(0,up_arrow,OBJPROP_ARROWCODE,241); // установим код стрелки
      ObjectSetInteger(0,up_arrow,OBJPROP_TIME,time); // зададим время
      ObjectSetDouble(0,up_arrow,OBJPROP_PRICE,lastClose[0]);// зададим цену
      ChartRedraw(0); // перерисуем окно
   }
   else
     Print("Не удалось получить последнюю цену Close!");
}