Справочник по языку программирования MQL5
Подождите немного. Документ загружается.
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1311
{
//--- set level width of chart object
object.LevelWidth(i,1);
}
}
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1312
LevelValue (метод Get)
Получает значение указанного уровня графического объекта.
double LevelValue(
int level // номер уровня
) const
Параметры
level
[in] Номер уровня графического объекта.
Возвращаемое значение
Значение указанного уровня графического объекта, привязанного к экземпляру класса. Если
нет привязанного объекта, либо у объекта нет указанного уровня, возвращается EMPTY_VALUE.
LevelValue (метод Set)
Устанавливает значение указанного уровня графического объекта.
bool LevelValue(
int level, // номер уровня
double new_value // новое значение
)
Параметры
level
[in] Номер уровня графического объекта.
new_value
[in] Новое значение указанного уровня графического объекта.
Возвращаемое значение
true – в случае удачи, false – если не удалось изменить значение уровня.
Пример:
//--- example for CChartObject::LevelValue
#include <ChartObjects\ChartObject.mqh>
//---
void OnStart()
{
CChartObject object;
//---
for(int i=0;i<object.LevelsCount();i++)
{
//--- get level value of chart object
double level_value=object.LevelValue(i);
if(level_value!=0.1*i)
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1313
{
//--- set level value of chart object
object.LevelValue(i,0.1*i);
}
}
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1314
LevelDescription (метод Get)
Получает описание (текст) указанного уровня графического объекта.
string LevelDescription(
int level // номер уровня
) const
Параметры
level
[in] Номер уровня графического объекта.
Возвращаемое значение
Описание (текст) указанного уровня графического объекта, привязанного к экземпляру класса.
Если нет привязанного объекта, либо у объекта нет указанного уровня, возвращается NULL.
LevelDescription (метод Set)
Устанавливает описание (текст) указанного уровня графического объекта.
bool LevelDescription(
int level, // номер уровня
string text // текст
)
Параметры
level
[in] Номер уровня графического объекта.
text
[in] Новое значение описания (текста) указанного уровня графического объекта.
Возвращаемое значение
true – в случае удачи, false – если не удалось изменить описание (текст).
Пример:
//--- example for CChartObject::LevelDescription
#include <ChartObjects\ChartObject.mqh>
//---
void OnStart()
{
CChartObject object;
//---
for(int i=0;i<object.LevelsCount();i++)
{
//--- get level description of chart object
string level_description=object.LevelDescription(i);
if(level_description=="")
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1315
{
//--- set level description of chart object
object.LevelDescription(i,"Level_"+IntegerToString(i));
}
}
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1316
GetInteger
Обеспечивает упрощенный доступ к функциям API MQL5 ObjectGetInteger() для получения
значений integer-свойств (имеющих типы bool, char, uchar, short, ushort, int, uint, ling, ulong,
datetime, color) привязанного к экземпляру класса графического объекта. Существуют два
варианта вызова функции:
Получение значения свойства без проверки корректности
long GetInteger(
ENUM_OBJECT_PROPERTY_INTEGER prop_id, // идентификатор integer-свойства
int modifier=-1 // модификатор
) const
Параметры
prop_id
[in] Идентификатор double-свойства графического объекта.
modifier=-1
[in] Модификатор (индекс) double-свойства.
Возвращаемое значение
Значение integer-свойства – в случае удачи, 0 - если нет возможности получить integer-
свойство.
Получение значения свойства с проверкой корректности такого обращения
bool GetInteger(
ENUM_OBJECT_PROPERTY_INTEGER prop_id, // идентификатор integer-свойства
int modifier, // модификатор
long& value // ссылка на переменную
) const
Параметры
prop_id
[in] Идентификатор integer-свойства графического объекта.
modifier
[in] Модификатор (индекс) integer-свойства.
value
[out] Ссылка на переменную для размещения значения integer-свойства.
Возвращаемое значение
true – в случае удачи, false - если нет возможности получить integer-свойство.
Пример:
//--- example for CChartObject::GetInteger
#include <ChartObjects\ChartObject.mqh>
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1317
//---
void OnStart()
{
CChartObject object;
//--- get color of chart object by easy method
printf("Objects color is %s",ColorToString(object.GetInteger(OBJPROP_COLOR),true));
//--- get color of chart object by classic method
long color_value;
if(!object.GetInteger(OBJPROP_COLOR,0,color_value))
{
printf("Get integer property error %d",GetLastError());
return;
}
else
printf("Objects color is %s",color_value);
for(int i=0;i<object.LevelsCount();i++)
{
//--- get levels width by easy method
printf("Level %d width is %d",i,object.GetInteger(OBJPROP_LEVELWIDTH,i));
//--- get levels width by classic method
long width_value;
if(!object.GetInteger(OBJPROP_LEVELWIDTH,i,width_value))
{
printf("Get integer property error %d",GetLastError());
return;
}
else
printf("Level %d width is %d",i,width_value);
}
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1318
SetInteger
Обеспечивает упрощенный доступ к функциям API MQL5 ObjectSetInteger() для изменения integer-
свойств (имеющих типы bool, char, uchar, short, ushort, int, uint, ling, ulong, datetime, color)
привязанного к экземпляру класса графического объекта. Существуют два варианта вызова
функции:
Установка значения свойства, не требующего модификатора
bool SetInteger(
ENUM_OBJECT_PROPERTY_INTEGER prop_id, // идентификатор integer-свойства
long value // значение
)
Параметры
prop_id
[in] Идентификатор integer-свойства графического объекта.
value
[in] Новое значение изменяемого integer-свойства.
Установка значения свойства с указанием модификатора
bool SetInteger(
ENUM_OBJECT_PROPERTY_INTEGER prop_id, // идентификатор integer-свойства
int modifier, // модификатор
long value // значение
)
Параметры
prop_id
[in] Идентификатор integer-свойства графического объекта.
modifier
[in] Модификатор (индекс) integer-свойства.
value
[in] Новое значение изменяемого integer-свойства.
Возвращаемое значение
true – в случае удачи, false - если нет возможности изменить integer-свойство.
Пример:
//--- example for CChartObject::SetInteger
#include <ChartObjects\ChartObject.mqh>
//---
void OnStart()
{
CChartObject object;
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1319
//--- set new color of chart object
if(!object.SetInteger(OBJPROP_COLOR,clrRed))
{
printf("Set integer property error %d",GetLastError());
return;
}
for(int i=0;i<object.LevelsCount();i++)
{
//--- set levels width
if(!object.SetInteger(OBJPROP_LEVELWIDTH,i,i))
{
printf("Set integer property error %d",GetLastError());
return;
}
}
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1320
GetDouble
Обеспечивает упрощенный доступ к функциям API MQL5 ObjectGetDouble() для получения
значений double-свойств (имеющих типы float и double) привязанного к экземпляру класса
графического объекта. Существуют два варианта вызова функции:
Получение значения свойства без проверки корректности
double GetDouble(
ENUM_OBJECT_PROPERTY_DOUBLE prop_id, // идентификатор double-свойства
int modifier=-1 // модификатор
) const
Параметры
prop_id
[in] Идентификатор double-свойства графического объекта.
modifier=-1
[in] Модификатор (индекс) double-свойства.
Возвращаемое значение
Значение double-свойства – в случае удачи, EMPTY_VALUE - если нет возможности получить
double-свойство.
Получение значения свойства с проверкой корректности такого обращения
bool GetDouble(
ENUM_OBJECT_PROPERTY_DOUBLE prop_id, // идентификатор double-свойства
int modifier, // модификатор
double& value // ссылка на переменную
) const
Параметры
prop_id
[in] Идентификатор double-свойства графического объекта.
modifier
[in] Модификатор (индекс) double-свойства.
value
[out] Ссылка на переменную для размещения значения double-свойства.
Возвращаемое значение
true – в случае удачи, false - если нет возможности получить double-свойство.
Пример:
//--- example for CChartObject::GetDouble
#include <ChartObjects\ChartObject.mqh>
//---