Справочник по языку программирования MQL5
Подождите немного. Документ загружается.
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1321
void OnStart()
{
CChartObject object;
//---
for(int i=0;i<object.LevelsCount();i++)
{
//--- get levels value by easy method
printf("Level %d value=%f",i,object.GetDouble(OBJPROP_LEVELVALUE,i));
//--- get levels value by classic method
double value;
if(!object.SetDouble(OBJPROP_LEVELVALUE,i,value))
{
printf("Get double property error %d",GetLastError());
return;
}
else
printf("Level %d value=%f",i,value);
}
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1322
SetDouble
Обеспечивает упрощенный доступ к функциям API MQL5 ObjectSetDouble() для изменения double-
свойств (имеющих типы float и double) привязанного к экземпляру класса графического объекта.
Существуют два варианта вызова функции:
Установка значения свойства, не требующего модификатора
bool SetDouble(
ENUM_OBJECT_PROPERTY_DOUBLE prop_id, // идентификатор double-свойства
double value // значение
)
Параметры
prop_id
[in] Идентификатор double-свойства графического объекта.
value
[in] Новое значение изменяемого double-свойства.
Установка значения свойства с указанием модификатора
bool SetDouble(
ENUM_OBJECT_PROPERTY_DOUBLE prop_id, // идентификатор double-свойства
int modifier, // модификатор
double value // значение
)
Параметры
prop_id
[in] Идентификатор double-свойства графического объекта.
modifier
[in] Модификатор (индекс) double-свойства.
value
[in] Новое значение изменяемого double-свойства.
Возвращаемое значение
true – в случае удачи, false - если нет возможности изменить double-свойство.
Пример:
//--- example for CChartObject::SetDouble
#include <ChartObjects\ChartObject.mqh>
//---
void OnStart()
{
CChartObject object;
//---
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1323
for(int i=0;i<object.LevelsCount();i++)
{
//--- set level value of chart object
if(!object.SetDouble(OBJPROP_LEVELVALUE,i,0.1*i))
{
printf("Set double property error %d",GetLastError());
return;
}
}
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1324
GetString
Обеспечивает упрощенный доступ к функциям API MQL5 ObjectGetString() для получения значений
string-свойств, привязанного к экземпляру класса графического объекта. Существуют два
варианта вызова функции:
Получение значения свойства без проверки корректности
string GetString(
ENUM_OBJECT_PROPERTY_STRING prop_id, // идентификатор string-свойства
int modifier=-1 // модификатор
) const
Параметры
prop_id
[in] Идентификатор string-свойства графического объекта.
modifier=-1
[in] Модификатор (индекс) string-свойства.
Возвращаемое значение
Значение string-свойства – в случае удачи, "" - если нет возможности получить string-свойство.
Получение значения свойства с проверкой корректности такого обращения
bool GetString(
ENUM_OBJECT_PROPERTY_STRING prop_id, // идентификатор string-свойства
int modifier, // модификатор
string& value // ссылка на переменную
) const
Параметры
prop_id
[in] Идентификатор string-свойства графического объекта.
modifier
[in] Модификатор (индекс) string-свойства.
value
[out] Ссылка на переменную для размещения значения string-свойства.
Возвращаемое значение
true – в случае удачи, false - если нет возможности получить string-свойство.
Пример:
//--- example for CChartObject::GetString
#include <ChartObjects\ChartObject.mqh>
//---
void OnStart()
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1325
{
CChartObject object;
string value;
//--- get name of chart object by easy method
printf("Object name is '%s'",object.GetString(OBJPROP_NAME));
//--- get name of chart object by classic method
if(!object.GetString(OBJPROP_NAME,0,value))
{
printf("Get string property error %d",GetLastError());
return;
}
else
printf("Object name is '%s'",value);
for(int i=0;i<object.LevelsCount();i++)
{
//--- get levels description by easy method
printf("Level %d description is '%s'",i,object.GetString(OBJPROP_LEVELTEXT,i));
//--- get levels description by classic method
if(!object.GetString(OBJPROP_LEVELTEXT,i,value))
{
printf("Get string property error %d",GetLastError());
return;
}
else
printf("Level %d description is '%s'",i,value);
}
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1326
SetString
Обеспечивает упрощенный доступ к функциям API MQL5 ObjectSetString() для изменения string-
свойств, привязанного к экземпляру класса графического объекта. Существуют два варианта
вызова функции:
Установка значения свойства, не требующего модификатора
bool SetString(
ENUM_OBJECT_PROPERTY_STRING prop_id, // идентификатор string-свойства
string value // значение
)
Параметры
prop_id
[in] Идентификатор string-свойства графического объекта.
value
[in] Новое значение изменяемого string-свойства.
Установка значения свойства с указанием модификатора
bool SetString(
ENUM_OBJECT_PROPERTY_STRING prop_id, // идентификатор string-свойства
int modifier, // модификатор
string value // значение
)
Параметры
prop_id
[in] Идентификатор string-свойства графического объекта.
modifier
[in] Модификатор (индекс) string-свойства.
value
[in] Новое значение изменяемого string-свойства.
Возвращаемое значение
true – в случае удачи, false - если нет возможности изменить string-свойство.
Пример:
//--- example for CChartObject::SetString
#include <ChartObjects\ChartObject.mqh>
//---
void OnStart()
{
CChartObject object;
//--- set new name of chart object
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1327
if(!object.SetString(OBJPROP_NAME,"MyObject"))
{
printf("Set string property error %d",GetLastError());
return;
}
for(int i=0;i<object.LevelsCount();i++)
{
//--- set levels description
if(!object.SetString(OBJPROP_LEVELTEXT,i,"Level_"+IntegerToString(i)))
{
printf("Set string property error %d",GetLastError());
return;
}
}
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1328
Save
Сохраняет параметры объекта в файле.
virtual bool Save(
int file_handle // хэндл файла
)
Параметры
file_handle
[in] хэндл ранее открытого при помощи функции FileOpen(...) файла.
Возвращаемое значение
true – в случае успешного завершения, false – в случае ошибки.
Пример:
//--- example for CChartObject::Save
#include <ChartObjects\ChartObject.mqh>
//---
void OnStart()
{
int file_handle;
CChartObject object=new CChartObject;
//--- set object parameters
//--- . . .
//--- open file
file_handle=FileOpen("MyFile.bin",FILE_WRITE|FILE_BIN|FILE_ANSI);
if(file_handle>=0)
{
if(!object.Save(file_handle))
{
//--- file save error
printf("File save: Error %d!",GetLastError());
FileClose(file_handle);
//---
return;
}
FileClose(file_handle);
}
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1329
Load
Загружает параметры объекта из файла.
virtual bool Load(
int file_handle // хэндл файла
)
Параметры
file_handle
[in] хэндл ранее открытого при помощи функции FileOpen(...) файла.
Возвращаемое значение
true – в случае успешного завершения, false – в случае ошибки.
Пример:
//--- example for CChartObject::Load
#include <ChartObjects\ChartObject.mqh>
//---
void OnStart()
{
int file_handle;
CChartObject object;
//--- open file
file_handle=FileOpen("MyFile.bin",FILE_READ|FILE_BIN|FILE_ANSI);
if(file_handle>=0)
{
if(!object.Load(file_handle))
{
//--- file load error
printf("File load: Error %d!",GetLastError());
FileClose(file_handle);
//---
return;
}
FileClose(file_handle);
}
//--- use object
//--- . . .
}
Стандартная библиотека
© 2000-2011, MetaQuotes Software Corp.
1330
Type
Получает идентификатор типа графического объекта.
virtual int Type() const
Возвращаемое значение
Идентификатор типа объекта (для CChartObject – 0x8888).
Пример:
//--- example for CChartObject::Type
#include <ChartObjects\ChartObject.mqh>
//---
void OnStart()
{
CChartObject object;
//--- get object type
int type=object.Type();
}