Блог компании Os_Engine | Пример «Таблица в окне параметров 2» CustomTableInTheParamWindowSample.

В окно параметров OsEngine можно выводить не только параметры, но и другие элементы, включая таблицы и чарты.

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

В нем показано:

• Динамическая таблица: Таблица обновляется в реальном времени по мере поступления новых данных.
• Взаимодействие с пользователем: Пользователь может изменять данные в таблице и получать значения конкретных ячеек.
• Настраиваемые параметры: Возможность включать и отключать робота и также настройка трейлинг-стопа для выхода.

1. Как это выглядит.

Заходим в тестер и запускаем нашего робота, открываем окно параметров.

Называется: CustomTableInTheParamWindowSample.

1. Вкладка настроек «Base settings»:

В ней находятся настройки:

• Contracts – кол-во контрактов инструмента.
• Contract currency – валюта контракта.
• Deposit percent – процент от депозита.

2. Вкладка настроек «Table settings»:

Здесь у нас находится сама таблица:

• Security – столбец с названием бумаг.
• Count candle – глубина данных, на которую проверяем движение (Movement to enter).
• Movement to enter – этот столбец мы тоже сами заполняем, он нам потребуется в торговой логике. Если Current movement будет больше Movement to enter, мы заходим в позицию.
• Current movement – текущий процент движения цены бумаги.
• Side – выбор метода входа для каждой бумаги.

2. Где найти робота в проекте?

Ссылка на робота GitHub: https://github.com/AlexWan/OsEngine

3. Разбор робота.

Строки 1-11:

Импортируются необходимые пространства имен:

Строки 23-26:

Определяется пространство имен OsEngine.Robots.TechSamples для организации кода и класс CustomTableInTheParamWindowSample наследует от BotPanel:

Строки31-39:

Переопределение методов GetNameStrategyType и ShowIndividualSettingsDialog.

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

Строка 44-49:

Создание параметров робота:

Строки 51-52:

Инициализируется панель бота:

Cоздается одна вкладка скринера и сохраняется ссылка на вкладку в _tab для дальнейшего использования.

Строки 56-64:

Создание вкладки и самой таблицы для нее:

Создание вкладки и настройка ее размеров.

Строка 68:

Вызов метода LoadLines:

Строки 72-74:

Подписка на события:

Событие завершения свечи, удаление робота и обновление значений таблицы.

Строки 83-96:

Этот блок отвечает за набор переменных робота:

Строки 101-118:

Метод передает изменения, внесенные пользователем в логику робота:

Метод CellValueChanget:

• Проходит по каждой строке в DataGridView.

• Извлекает значения из ячеек текущей строки и присваивает их соответствующим свойствам объектов в коллекции Lines.
• Security: Строковое значение из первой ячейки.
• CandleCount: Целочисленное значение из второй ячейки.
• MovementToEnter: Десятичное число из третьей ячейки.
• Side: Перечисление типа Side, полученное из пятой ячейки.

• Вызывает метод SaveLines() для сохранения обновленных данных.

• Оборачивает весь код в блок try-catch для перехвата возможных исключений.
• При возникновении исключения записывает его сообщение в лог с помощью метода _tab.SendNewLogMessage().

Строки 123-129:

Данный метод вызывается при удалении робота:

Метод DeleteBotEvent:

• Метод File.Exists проверяет, существует ли файл по указанному пути.

• Если файл существует, метод File.Delete удаляет его.

Строки 134-152:

Сохраняем данные из таблицы в .txt файл:

Метод SaveLines:

• Создает новый поток записи (StreamWriter) в указанном файле. Файл создается или перезаписывается в зависимости от второго аргумента конструктора (false).

• Каждая строка записывается в файл, разделяя ячейки знаком “%”.

• Закрывает поток записи.

• Оборачивает весь код в блок try-catch для перехвата возможных исключений.
• При возникновении исключения записывает его сообщение в лог с помощью метода _tab.SendNewLogMessage().

Строки 157-187:

Загружаем сохраненные данные в таблицу:

Метод LoadLines:

• Проверяет, существует ли файл с указанным именем.

• Если файл существует, открывает его для чтения.
• Читает каждую строку из файла и создает новый объект TableBotLine.
• Добавляет созданный объект в коллекцию Lines.
• Закрывает поток чтения.

• Добавляет новые строки в DataGridView на основе данных из коллекции Lines.

Строки 193-199:

Событие завершения свечи:

Метод _tab_CandleFinishedEvent:

1. _tab_CandleFinishedEvent(List<Candle> candles, BotTabSimple tab):

• Этот метод вызывается при завершении каждой свечи.
• Аргумент tab представляет собой объект, который содержит информацию об этой новой вкладке.
• Вызываются все методы, находящиеся внутри.

Строки 204-261:

Метод, отвечающий за создание столбцов в таблице:

Метод CreateColumnsTable:

• MainWindow.GetDispatcher.CheckAccess(): Проверяет, вызывается ли метод из UI-потока.
• Если метод вызывается не из UI-потока, то он рекурсивно вызывает себя в контексте UI-потока, чтобы обеспечить безопасное обновление пользовательского интерфейса.

• Создается объект WindowsFormsHost, который позволяет разместить элемент управления Windows Forms (DataGrid) в приложении WPF.

• Создается объект DataGrid, и настраиваются его основные свойства:
  • Режим выбора строк: Выбирается режим, при котором можно выбрать всю строку целиком.
  • Автоматическое изменение высоты строк: Строки будут автоматически подстраиваться по высоте содержимого.
  • Выравнивание текста: Текст в ячейках выравнивается по центру как по горизонтали, так и по вертикали.

• Создаются пять столбцов с названиями «Security», «Count candle», «Movement to enter», «Сurrent movement» и «Side».
• Для каждого столбца задается тип ячейки (DataGridViewTextBoxCell), ширина столбца (автоматическое заполнение) и заголовок.

• Созданные столбцы добавляются в коллекцию столбцов DataGrid.

• Объект DataGrid устанавливается в качестве дочернего элемента объекта WindowsFormsHost.

• В блоке try-catch обрабатываются возможные исключения. В случае ошибки выводится сообщение в лог.

Строки 266-302:

Метод, который добавляет новые строки в таблицу:

Метод AddNewLineInTable:

1. Проверка наличия инструмента:

• Если для вкладки не задан финансовый инструмент (tab.Security == null), метод прерывает свою работу.

• Происходит итерация по всем строкам таблицы.
• Если значение в первом столбце строки (название инструмента) совпадает с названием инструмента текущей вкладки, то считается, что строка для этого инструмента уже существует.

• Если строка для инструмента не найдена, создается новый объект TableBotLine с необходимыми значениями (название инструмента, количество свечей, движение для входа и т.д.).
• Этот объект добавляется в коллекцию строк.
• Вызывается метод CreateRowsTable для обновления отображения таблицы.

Строки 307-325:

Методы для обновления отображения таблицы:

Метод CreateRowsTable:

• _tableDataGrid.InvokeRequired: Проверяет, вызывается ли метод из UI-потока.
• Если метод вызывается не из UI-потока, то он рекурсивно вызывает себя в контексте UI-потока, чтобы обеспечить безопасное обновление пользовательского интерфейса.

• Вызывает метод CreateLine для создания новой строки данных и добавляет ее в таблицу.

• Вызывает метод SaveLines для сохранения изменений в таблице.

• В блоке try-catch обрабатываются возможные исключения. В случае ошибки выводится сообщение в лог.

Строки 327-364:

Этот метод создает линию и возвращает ее вызывающему методу:

Метод CreateLine:

• Создается новый объект DataGridViewRow — строка для таблицы.

• Для каждого поля объекта TableBotLine создается соответствующая ячейка таблицы (DataGridViewTextBoxCell или DataGridViewComboBoxCell).
• Ячейки добавляются в коллекцию ячеек строки (row.Cells.Add).
• Для некоторых ячеек устанавливается свойство ReadOnly = true, что делает их содержимое неизменяемым пользователем.

• В блоке try-catch происходит заполнение ячеек значениями из объекта Lines[index]:
  • Ячейка «Security» заполняется названием инструмента.
  • Ячейка «CandleCount» заполняется количеством свечей для расчета текущего движения.
  • Ячейка «MovementToEnter» заполняется значением движения для входа.
  • Ячейка «CurrentMovement» заполняется значением текущего движения с добавлением символа процента "%".
  • Ячейка «Side» заполняется текстовым представлением стороны сделки («Buy» или «Sell») на основе значения поля Side объекта TableBotLine.

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

• Заполненная строка таблицы возвращается вызывающему методу.

Строки 369-420:

Этот метод сортирует линии:

\

Метод SortLine:

• _tableDataGrid.InvokeRequired: Проверяет, вызывается ли метод из UI-потока.
• Если метод вызван не из UI-потока, то он рекурсивно вызывает себя в контексте UI-потока для безопасного обновления интерфейса.

• Проверяет, содержит ли последняя строка таблицы какое-либо значение в первом столбце (_tableDataGrid.Rows[_tableDataGrid.Rows.Count — 1].Cells[0].Value.ToString()).
• Если значение отсутствует, метод завершается, не выполняя дальнейшую обработку.

• Внешний цикл: Перебирает все строки таблицы (_tableDataGrid.Rows.Count).

• Внутренний цикл: Перебирает все вкладки приложения (_tab.Tabs.Count).
• Для каждой строки проверяет, совпадает ли название инструмента в первом столбце (_tableDataGrid.Rows[i].Cells[0].Value.ToString()) с названием инструмента какой-либо вкладки.
• Если совпадение найдено, флаг GotLine устанавливается в true, что означает, что строка найдена.

• После прохода по всем строкам, если флаг GotLine остался false (ни для одной строки не найдено совпадение со вкладкой), значит, эта строка не нужна.
• Индекс ненужной строки сохраняется в переменной indexLine.
• Строка с этим индексом удаляется из таблицы с помощью метода _tableDataGrid.Rows.Remove.
• Вызывается метод SaveLines для сохранения изменений.

• В блоке try-catch обрабатываются возможные исключения при работе с данными. В случае ошибки выводится сообщение в лог.

Строки 425-479:

Метод обновления текущего процента движения:

Метод MovementPercentUpdate:

• _tableDataGrid.InvokeRequired: Проверяет, вызывается ли метод из UI-потока.
• Если метод вызван не из UI-потока, то он рекурсивно вызывает себя в контексте UI-потока для безопасного обновления интерфейса.

• Ищет строку в таблице, соответствующую инструменту из вкладки (tab.Security.Name).
• Перебирает все строки коллекции Lines и сравнивает значения поля Security с названием инструмента.
• Если совпадение найдено, то сохраняется индекс строки (indexLine) и флаг GotLine устанавливается в true.

• Сравнивает количество свечей в полученном списке свечей (candles.Count) с количеством свечей, указанным в найденной строке таблицы (TableCandlesCount).
• Если количество свечей в списке меньше, чем в таблице, метод завершает работу, так как для расчета недостаточно данных.

• Если строка найдена (GotLine == true), выполняется расчет процента изменения цены в зависимости от направления сделки (Lines[indexLine].Side):
• Для сделок на покупку (Buy): рассчитывается изменение цены как разница между ценой закрытия предпоследней свечи (candles[candles.Count — Lines[indexLine].CandelCount].Close) и ценой закрытия последней свечи (candles[candles.Count — 1].Close), деленная на цену закрытия последней свечи и умноженная на 100.
• Для сделок на продажу (Sell): расчет аналогичен, но разница цен берется с обратным знаком.
• Результат расчета округляется до двух знаков после запятой (Math.Round) и сохраняется в поле CurrentMovement объекта Lines[indexLine].
• Значение процента изменения цены с добавлением символа "%" устанавливается в соответствующую ячейку таблицы (_tableDataGrid.Rows[indexLine].Cells[3].Value).

• Вызывается метод SaveLines для сохранения изменений в таблице данных.

• В блоке try-catch обрабатываются возможные исключения при работе с данными. В случае ошибки выводится сообщение в лог.

Строки 488-565:

Торговая логика:

Метод TradeLogicMethod:

• Если значение равно «Off», то метод завершается, не выполняя дальнейшие действия.

• Если список пустой, метод завершается, так как для анализа недостаточно данных.

• Перебирает все строки коллекции Lines и сравнивает значения поля Security с названием инструмента.
• Если совпадение найдено, то сохраняется индекс строки (indexLine), и флаг GotLine устанавливается в true.

• Если строка в таблице не найдена (GotLine == false), метод завершается.

• Из вкладки (tab) извлекается список открытых позиций (positions.Count).

• Если открытых позиций нет (positions.Count == 0), выполняется проверка условия для открытия позиции:
  • Проверяем, не превышает ли общее количество позиций максимального значение, если превышает, то выходим.
  • Значение движения для входа в позицию (movementToEnter) извлекается из соответствующей ячейки таблицы (_tableDataGrid.Rows[indexLine].Cells[2].Value.ToString()) и преобразуется в десятичное число.
  • Сравнивается текущее движение цены (Lines[indexLine].CurrentMovement) с заданным движением для входа.
  • Если текущее движение превышает заданное значение (movementToEnter < Lines[indexLine].CurrentMovement), в зависимости от направления сделки выполняется покупка по рынку с объемом лота, который рассчитывает метод GetVolume, и продажа по рынку с объемом лота, который рассчитывает метод GetVolume.

• Если позиция не открыта (PositionStateType.Open), метод завершается.
• В зависимости от направления открытой позиции (positions[0].Direction):

1. Для позиции на покупку (Buy) рассчитывается цена стоп-лосса как разница между минимальной ценой последней свечи и произведением этой цены и значения трейлинга, деленным на 100.
   
2. Для позиции на продажу (Sell) рассчитывается цена стоп-лосса как сумма максимальной цены последней свечи и произведения этой цены и значения трейлинга, деленным на 100.

• Вызывается метод CloseAtTrailingStop вкладки для обновления стоп-лосса открытой позиции (positions[0]) по рассчитанной цене.

Строки 567-656:

Метод GetVolume:

• Создается переменная volume со значением 0 для хранения результата.

• Контракты: Если тип объема установлен как «Contracts», то в качестве объема используется значение из переменной Volume.
• Контрактная валюта:
  • Если тип объема установлен как «Contract currency», то объем рассчитывается делением значения Volume на цену последнего спроса.
  • Корректировка для OS Trader: Если приложение запущено в режиме OS Trader, то объем дополнительно корректируется с учетом лота инструмента и настроек сервера.
  • Округление: Результат округляется до числа десятичных знаков, указанного в настройках инструмента.
• Процент от депозита:
• Если тип объема установлен как «Deposit percent», то:
• Определяется текущая стоимость портфеля в основной валюте.
• Рассчитывается сумма денег, которую необходимо вложить в сделку, исходя из указанного процента от портфеля.
• Объем рассчитывается делением этой суммы на цену последнего спроса и лот инструмента.
• Результат округляется.

• Возвращается вычисленное значение объема.

Строки 661-696:

Отдельный класс для хранения и передачи данных о строках таблицы:

Свойства:

• Security: Строка, содержащая название финансового инструмента.
• CandelCount: Целое число, указывающее количество свечей, связанных с этим инструментом.
• MovementToEnter: Десятичное число, представляющее значение движения цены, необходимое для входа в позицию.
• CurrentMovement: Десятичное число, представляющее текущее движение цены.
• Side: Перечисление (enum), определяющее сторону сделки (покупка или продажа).

Метод GetSaveStr:

• Инициализация строки: Создается пустая строка saveStr, которая будет использоваться для сборки конечного результата.
• Конкатенация значений:
• К строке saveStr последовательно добавляются значения переменных Security, CandleCount, MovementToEnter и CurrentMovement, разделенных символом процента (%).
• Затем добавляется значение переменной Side без дополнительного разделителя.
• Возврат результата: Готовая строка возвращается как результат работы метода.

Метод SetFromStr:

• Разбиение строки: Строка разбивается на массив строк по знаку “%”.
• Заполнение свойств:
• Security: Первое значение массива присваивается свойству Security.
• CandelCount: Второе значение преобразуется в целое число и присваивается свойству CandleCount.
• MovementToEnter: Третье значение преобразуется в десятичное число и присваивается свойству MovementToEnter.
• CurrentMovement: Четвертое значение очищается от последнего символа (предполагается, что это символ процента) и преобразуется в десятичное число, присваивается свойству CurrentMovement.
• Side: Пятое значение используется для попытки преобразования в перечисление Side. Если преобразование успешно, значение присваивается свойству Side.

Вывод: этот пример робота будет полезен для демонстрации, как создавать и настраивать кастомные элементы в окне параметров робота. Он показывает, как создавать таблицу для вывода значений и использование ее пользователями, что может служить готовым шаблоном для реализации подобных задач.

Удачных алгоритмов!

Комментарии открыты для друзей!

OsEngine: https://github.com/AlexWan/OsEngine
Поддержка OsEngine: https://t.me/osengine_official_support

Регистрируйся в АЛОР и получай бонусы: https://www.alorbroker.ru/open
Сайт АЛОР БРОКЕР: https://www.alorbroker.ru
Раздел «Для клиентов»: https://www.alorbroker.ru/openinfo/for-clients
Программа лояльности от АЛОР БРОКЕР и OsEngine: https://smart-lab.ru/company/os_engine/blog/972745.php