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

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

Операции с графиками

601

ChartNavigate

Осуществляет сдвиг указанного графика на указанное количество баров относительно указанной

позиции графика.

bool ChartNavigate(

long chart_id, // идентификатор графика

int position, // позиция

int shift=0 // значение сдвига

);

Параметры

chart_id

[in] Идентификатор графика. 0 означает текущий график.

position

[in] Позиция графика, относительно которой будет произведено смещение. Значение может

быть одним из значений перечисления ENUM_CHART_POSITION.

shift=0

[in] Количество баров, на которое необходимо сместить график. Положительное значение

означает смещение вправо (к концу графика), отрицательное значение означает смещение

влево (к началу графика). Нулевое смещение имеет смысл, когда производится навигация к

началу или концу графика.

Возвращаемое значение

Возвращает true в случае успеха, иначе false.

Пример:

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

//| Script program start function |

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

void OnStart()

{

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

long handle=ChartID();

string comm="";

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

{

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

ChartSetInteger(handle,CHART_AUTOSCROLL,false);

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

ChartSetInteger(handle,CHART_SHIFT,true);

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

ChartSetInteger(handle,CHART_MODE,CHART_CANDLES);

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

ChartSetInteger(handle,CHART_SHOW_VOLUMES,CHART_VOLUME_TICK);

//--- подготовим текст для вывода в Comment()

Операции с графиками

602

comm="Прокрутим на 10 баров вправо от начала истории";

//--- выведем комментарий

Comment(comm);

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

ChartNavigate(handle,CHART_BEGIN,10);

//--- получим номер самого первого видимого на графике бара (нумерация как в таймсерии)

long first_bar=ChartGetInteger(0,CHART_FIRST_VISIBLE_BAR,0);

//--- добавим символ переноса строки

comm=comm+"\r\n";

//--- дополним коментарий

comm=comm+"Первый бар на графике имеет номер "+IntegerToString(first_bar)+"\r\n";

//--- выведем комментарий

Comment(comm);

//--- подождем 5 секунд, чтобы успеть увидеть, как двигается график

Sleep(5000);

//--- допишем текст комментария

comm=comm+"\r\n"+"Прокрутим на 10 баров влево от правого края графика";

Comment(comm);

//--- прокрутим на 10 баров влево от правого края графика

ChartNavigate(handle,CHART_END,-10);

//--- получим номер самого первого видимого на графике бара (нумерация как в таймсерии)

first_bar=ChartGetInteger(0,CHART_FIRST_VISIBLE_BAR,0);

comm=comm+"\r\n";

comm=comm+"Первый бар на графике имеет номер "+IntegerToString(first_bar)+"\r\n";

Comment(comm);

//--- подождем 5 секунд, чтобы успеть увидеть, как двигается график

Sleep(5000);

//--- новый блок прокрутки графика

comm=comm+"\r\n"+"Прокрутим на 300 баров вправо от начала истории";

Comment(comm);

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

ChartNavigate(handle,CHART_BEGIN,300);

first_bar=ChartGetInteger(0,CHART_FIRST_VISIBLE_BAR,0);

comm=comm+"\r\n";

comm=comm+"Первый бар на графике имеет номер "+IntegerToString(first_bar)+"\r\n";

Comment(comm);

//--- подождем 5 секунд, чтобы успеть увидеть, как двигается график

Sleep(5000);

//--- новый блок прокрутки графика

comm=comm+"\r\n"+"Прокрутим на 300 баров влево от правого края графика";

Comment(comm);

//--- прокрутим на 300 баров влево от правого края графика

ChartNavigate(handle,CHART_END,-300);

first_bar=ChartGetInteger(0,CHART_FIRST_VISIBLE_BAR,0);

comm=comm+"\r\n";

Операции с графиками

603

comm=comm+"Первый бар на графике имеет номер "+IntegerToString(first_bar)+"\r\n";

Comment(comm);

}

Операции с графиками

604

ChartID

Возвращает идентификатор текущего графика.

long ChartID();

Возвращаемое значение

Значение типа long.

Операции с графиками

605

ChartIndicatorAdd

Добавляет на указанное окно графика индикатор с указанным хэндлом.

bool ChartIndicatorAdd(

long chart_id, // идентификатор графика

int sub_window  // номер подокна

int indicator_handle  // хэндл индикатора

);

Параметры

chart_id

[in] Идентификатор графика. 0 означает текущий график.

sub_window

[in] Номер подокна графика. 0 означает главное окно графика. Если указан номер

несуществующего окна, то будет создано новое окно.

indicator_handle

[in] Хэндл индикатора.

Возвращаемое значение

Возвращает true в случае успеха, иначе false. Чтобы получить информацию об ошибке,

необходимо вызвать функцию GetLastError().

Смотри также

ChartIndicatorDelete(), ChartIndicatorName(), ChartIndicatorsTotal(), iCustom(), IndicatorCreate()

Операции с графиками

606

ChartIndicatorDelete

Удаляет с указанного окна графика индикатор с указанным именем.

bool ChartIndicatorDelete(

long chart_id, // идентификатор графика

int sub_window  // номер подокна

const string ind_shortname  // короткое имя индикатора

);

Параметры

chart_id

[in] Идентификатор графика. 0 означает текущий график.

sub_window

[in] Номер подокна графика. 0 означает главное окно графика.

const ind_shortname

[in] Короткое имя индикатора, которое задается в свойстве INDICATOR_SHORTNAME функцией

IndicatorSetString(). Получить короткое имя индикатора можно функцией ChartIndicatorName()

Возвращаемое значение

Возвращает true в случае успешного удаления индикатора, иначе false. Чтобы получить

информацию об ошибке, необходимо вызвать функцию GetLastError().

Примечание

Если в указанном подокне графика существует несколько индикаторов с одинаковым коротким

именем, то будет удален первый по порядку.

Если на значениях удаляемого индикатора построены другие индикаторы на этом же графике,

то они также будут удалены.

Не следует путать короткое имя индикатора и имя файла, которое указывается при создании

индикатора функциями iCustom() и IndicatorCreate(). Если короткое наименование индикатора

не задается явным образом, то при компиляции в нем указывается имя файла, содержащего

исходный код индикатора.

Удаление индикатора с графика не означает, что расчетная часть индикатора также будет

удалена из памяти терминала. Для освобождения хэндла индикатора используйте функцию

IndicatorRelease().

Необходимо правильно формировать короткое имя индикатора, которое с помощью функции

IndicatorSetString() записывается в свойство INDICATOR_SHORTNAME. Мы рекомендуем, чтобы

короткое имя содержало значения входных параметров индикатора, так как идентификация

удаляемого с графика индикатора в функции ChartIndicatorDelete() производится именно по

короткому имени.

Смотри также

ChartIndicatorAdd(), ChartIndicatorName(), ChartIndicatorsTotal(), iCustom(), IndicatorCreate(),

IndicatorSetString()

Операции с графиками

607

ChartIndicatorName

Возвращает короткое имя индикатора по номеру в списке индикаторов на указанном окна

графика.

string ChartIndicatorName(

long chart_id, // идентификатор графика

int sub_window  // номер подокна

int index  // индекс индикатора в списке индикаторов, добавленных к данному подокну графика

);

Параметры

chart_id

[in] Идентификатор графика. 0 означает текущий график.

sub_window

[in] Номер подокна графика. 0 означает главное окно графика.

index

[in] Индекс индикатора с списке индикаторов. Нумерация индикаторов начинается с нуля, то

есть самый первый индикатор в списке имеет нулевой индекс. Количество индикаторов в

списке можно получить функцией ChartIndicatorsTotal().

Возвращаемое значение

Короткое имя индикатора, которое задается в свойстве INDICATOR_SHORTNAME функцией

IndicatorSetString(). Чтобы получить информацию об ошибке, необходимо вызвать функцию

GetLastError().

Примечание

Не следует путать короткое имя индикатора и имя файла, которое указывается при создании

индикатора функциями iCustom() и IndicatorCreate(). Если короткое наименование индикатора

не задается явным образом, то при компиляции в нем указывается имя файла с исходным

кодом индикатора.

Необходимо правильно формировать короткое имя индикатора, которое с помощью функции

IndicatorSetString() записывается в свойство INDICATOR_SHORTNAME. Мы рекомендуем, чтобы

короткое имя содержало значения входных параметров индикатора, так как идентификация

удаляемого с графика индикатора в функции ChartIndicatorDelete() производится именно по

короткому имени.

Смотри также

ChartIndicatorAdd(), ChartIndicatorDelete(), ChartIndicatorsTotal(), iCustom(), IndicatorCreate(),

IndicatorSetString()

Операции с графиками

608

ChartIndicatorsTotal

Возвращает количество всех индикаторов, присоединенных к указанному окну графика.

int ChartIndicatorsTotal(

long chart_id, // идентификатор графика

int sub_window  // номер подокна

);

Параметры

chart_id

[in] Идентификатор графика. 0 означает текущий график.

sub_window

[in] Номер подокна графика. 0 означает главное окно графика.

Возвращаемое значение

Количество индикаторов на указанном окне графика. Чтобы получить информацию об ошибке,

необходимо вызвать функцию GetLastError().

Примечание

Функция предназначена для организации перебора всех индикаторов, присоединенных к

данному графику. Количества всех окон графика можно получить из свойства

CHART_WINDOWS_TOTAL функцией ChartGetInteger().

Смотри также

ChartIndicatorAdd(), ChartIndicatorDelete(), ChartIndicatorsTotal(), iCustom(), IndicatorCreate(),

IndicatorSetString()

Операции с графиками

609

ChartWindowOnDropped

Возвращает номер подокна графика, на которое брошен мышкой данный эксперт или скрипт. 0

означает главное окно графика.

int ChartWindowOnDropped();

Возвращаемое значение

Значение типа int.

Пример:

int myWindow=ChartWindowOnDropped();

int windowsTotal=ChartGetInteger(0,CHART_WINDOWS_TOTAL);

Print("Скрипт запущен на окне #"+myWindow+

". Всего окон на графике "+ChartSymbol()+":",windowsTotal);

Смотри также

ChartPriceOnDropped, ChartTimeOnDropped, ChartXOnDropped, ChartYOnDropped

Операции с графиками

610

ChartPriceOnDropped

Возвращает ценовую координату, соответствующую точке, в которой брошен мышкой данный

эксперт или скрипт.

double ChartPriceOnDropped();

Возвращаемое значение

Значение типа double.

Пример:

double p=ChartPriceOnDropped();

Print("ChartPriceOnDropped() = ",p);

Смотри также

ChartXOnDropped, ChartYOnDropped