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

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

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

611

ChartTimeOnDropped

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

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

datetime ChartTimeOnDropped();

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

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

Пример:

datetime t=ChartTimeOnDropped();

Print("Script wasdropped on the "+t);

Смотри также

ChartXOnDropped, ChartYOnDropped

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

612

ChartXOnDropped

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

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

int ChartXOnDropped();

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

Значение координаты X.

Примечание

Ось X направлена слева направо.

Пример:

int X=ChartXOnDropped();

int Y=ChartYOnDropped();

Print("(X,Y) = ("+X+","+Y+")");

Смотри также

ChartWindowOnDropped, ChartPriceOnDropped, ChartTimeOnDropped

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

613

ChartYOnDropped

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

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

int ChartYOnDropped();

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

Значение координаты Y.

Примечание

Ось Y направлена сверху вниз.

Смотри также

ChartWindowOnDropped, ChartPriceOnDropped, ChartTimeOnDropped

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

614

ChartSetSymbolPeriod

Меняет значения символа и периода указанного графика. Функция работает асинхронно, то есть

отдает команду и не ждет окончания ее выполнения.

bool ChartSetSymbolPeriod(

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

string symbol, // имя символа

ENUM_TIMEFRAMES period // период

);

Параметры

chart_id

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

symbol

[in] Символ графика. NULL oзначает символ текущего графика (к которому прикреплен

эксперт)

period

[in] Период графика (таймфрейм). Может принимать одно из значений значений

перечисления ENUM_TIMEFRAMES. 0 означает период текущего графика.

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

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

Примечание

Смена символа/периода влечет за собой переинициализацию эксперта, прикрепленного к

соответствующему графику.

Смотри также

ChartSymbol, ChartPeriod

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

615

ChartScreenShot

Функция обеспечивает скриншот указанного графика в его текущем состоянии в формате gif.

bool ChartScreenShot(

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

string filename, // имя файла

int width, // ширина

int height, // высота

ENUM_ALIGN_MODE align_mode=ALIGN_RIGHT // тип выравнивания

);

Параметры

chart_id

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

filename

[in] Имя файла скриншота. Не может превышать 63 символов. Скриншот помещается в

директорию \Files.

width

[in] Ширина скриншота в пикселях

height

[in] Высота скриншота в пикселях

align_mode=ALIGN_RIGHT

[in] Режим вывода узкого скриншота. ALIGN_RIGHT означает выравнивание по правой

границе (вывод с конца). ALIGN_LEFT означает выравнивание по левой границе.

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

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

Примечание

Если необходимо снять скриншот графика с определенной позиции, то необходимо сначала

позиционировать график при помощи функции ChartNavigate(). Если горизонтальный размер

скриншота меньше, чем окно графика, то выводится либо правая часть окна графика, либо

левая часть, в зависимости от значения параметра align_mode.

Торговые функции

616

Торговые функции

Группа функций, предназначенных для управления торговой деятельностью.

Торговые функции могут использоваться в экспертах и скриптах. Торговые функции могут быть

вызваны только в том случае, если в свойствах соответствующего эксперта или скрипта включена

галочка "Разрешить советнику торговать".

Функция

Действие

OrderCalcMargin

Вычисляет размер маржи, необходимой для

указанного типа ордера, в валюте счета

OrderCalcProfit

Вычисляет размер прибыли на основании

переданных параметров в валюте счета

OrderCheck

Проверяет достаточность средств для

совершения требуемой торговой операции.

OrderSend

Отправляет торговые запросы на сервер

PositionsTotal

Возвращает количество открытых позиций

PositionGetSymbol

Возвращает символ соответствующей

открытой позиции

PositionSelect

Выбирает открытую позицию для дальнейшей

работы с ней

PositionGetDouble

Возвращает запрошенное свойство открытой

позиции (double)

PositionGetInteger

Возвращает запрошенное свойство открытой

позиции (datetime или int)

PositionGetString

Возвращает запрошенное свойство открытой

позиции (string)

OrdersTotal

Возвращает количество ордеров

OrderGetTicket

Возвращает тикет соответствующего ордера

OrderSelect

Выбирает ордер для дальнейшей работы с

ним

OrderGetDouble

Возвращает запрошенное свойство ордера

(double)

OrderGetInteger

Возвращает запрошенное свойство ордера

(datetime или int)

OrderGetString

Возвращает запрошенное свойство ордера

(string)

HistorySelect

Запрашивает историю сделок и ордеров за

указанный период серверного времени

HistorySelectByPosition

Запрашивает историю сделок и ордеров c

Торговые функции

617

указанным идентификатором позиции.

HistoryOrderSelect

Выбирает в истории ордер для дальнейшей

работы с ним

HistoryOrdersTotal

Возвращает количество ордеров в истории

HistoryOrderGetTicket

Возвращает тикет соответствующего ордера в

истории

HistoryOrderGetDouble

Возвращает запрошенное свойство ордера в

истории (double)

HistoryOrderGetInteger

Возвращает запрошенное свойство ордера в

истории (datetime или int)

HistoryOrderGetString

Возвращает запрошенное свойство ордера в

истории (string)

HistoryDealSelect

Выбирает в истории сделку для дальнейших

обращений к ней через соответствующие

функции

HistoryDealsTotal

Возвращает количество сделок в истории

HistoryDealGetTicket

Выбирает сделку для дальнейшей обработки

и возвращает тикет сделки в истории

HistoryDealGetDouble

Возвращает запрошенное свойство сделки в

истории (double)

HistoryDealGetInteger

Возвращает запрошенное свойство сделки в

истории (datetime или int)

HistoryDealGetString

Возвращает запрошенное свойство сделки в

истории (string)

Торговые функции

618

OrderCalcMargin

Вычисляет размер маржи, необходимой для указанного типа ордера на текущем счете и при

текущем рыночном окружении без учета текущих отложенных ордеров и открытых позиций.

Позволяет оценить размер маржи для планируемой торговой операции. Значение возвращается в

валюте счета.

bool OrderCalcMargin(

ENUM_ORDER_TYPE action, // тип ордера

string symbol, // имя символа

double volume, // объем

double price, // цена открытия

double& margin  // переменная для получения значения маржи

);

Параметры

action

[in] Тип ордера, может принимать значения из перечисления ENUM_ORDER_TYPE.

symbol

[in] Имя финансового инструмента.

volume

[in] Объем торговой операции.

price

[in] Цена открытия.

margin

[out] Переменная, в которую будет записан необходимый размер маржи в случае успешного

выполнения функции. Вычисление производится как если бы на текущем счете не было

отложенных ордеров и открытых позиций. Значение маржи зависит от многих факторов и

может меняться при изменении рыночного окружения.

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

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

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

Смотри также

OrderSend(), Свойства ордеров, Типы торговых операций

Торговые функции

619

OrderCalcProfit

Вычисляет размер прибыли для текущего счета и рыночного окружения на основании переданных

параметров. Предназначена для предварительной оценки результата торговой операции.

Значение возвращается в валюте счета.

bool OrderCalcProfit(

ENUM_ORDER_TYPE action, // тип ордера (ORDER_TYPE_BUY или ORDER_TYPE_SELL)

string symbol, // имя символа

double volume, // объем

double price_open, // цена открытия

double price_close, // цена закрытия

double& profit // переменная для получения значения прибыли

);

Параметры

action

[in] Тип ордера, может принимать одно из двух значений перечисления ENUM_ORDER_TYPE:

ORDER_TYPE_BUY или ORDER_TYPE_SELL.

symbol

[in] Имя финансового инструмента.

volume

[in] Объем торговой операции.

price_open

[in] Цена открытия.

price_close

[in] Цена закрытия.

profit

[out] Переменная, в которую будет записано вычисленное значение прибыли в случае

успешного выполнения функции. Значение оценки прибыли зависит от многих факторов и

может меняться при изменении рыночного окружения.

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

Возвращает true в случае успеха, иначе false. Если указан недопустимый тип ордера, функция

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

GetLastError().

Смотри также

OrderSend(), Свойства ордеров, Типы торговых операций

Торговые функции

620

OrderCheck

Функция OrderCheck() проверяет достаточность средств для совершения требуемой торговой

операции. Результаты проверки помещаются в поля структуры MqlTradeCheckResult.

bool OrderCheck(

MqlTradeRequest& request, // структура запроса

MqlTradeCheckResult&  result  // структура ответа

);

Параметры

request

[in] Указатель на структуру типа MqlTradeRequest, которая описывает требуемое торговое

действие.

result

[in,out] Указатель на структуру типа MqlTradeCheckResult, в которую будет помещен

результат проверки.

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

В случае нехватки средств или ошибочно заполненных параметров функция возвращает false. В

случае успешной базовой проверки структур (проверка указателей) возвращается true – это не

является свидетельством того, что запрашиваемая торговая операция непременно

выполнится успешно. Для получения подробного описания результата выполнения функции

следует анализировать поля структуры result.

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

Смотри также

OrderSend(), Типы торговых операций, Структура торгового запроса, Структура результатов

проверки торгового запроса, Структура результата торгового запроса