Инструкция по работе с терминалом TSLab версии 1.2
2.6.2. Работа с API

Создание нового проекта с TSLab API
После установки и запуска SharpDevelop Пользователю необходимо создать новый проект с помощью меню: File — New — Solution.

В открывшемся окне в категории C# — Windows Applications необходимо выбрать Windows Application, ввести имя проекта, путь для сохранения, и, затем, нажать ОК.
В левой части экрана расположено окно менеджера файлов проекта. Вызвав контекстное меню над названием проекта, нужно выбрать пункт Properties.
В основной области рабочего пространства откроется вкладка свойств проекта Properties, где Output Type должен быть замене на Class Library.

Теперь Пользователю нужно перейти на вкладку Debug и указать путь к файлу TSLabApp.exe в поле Start external program.
Далее библиотеки TSLab API должны быть подключены к проекту. Для этого нужно открыть контекстное меню в менеджере файлов над папкой References и выбрать пункт Add Reference. В новом окне следует перейти на вкладку .Net Assembly Browser и нажать кнопку Browse. В папке, где установлен TSLab, удерживая клавишу Ctrl, нужно выбрать два файла — TSLab.Datasource.dll и TSLab.Script.dll, после чего нажать Оpen. В предыдущем окне также необходимо подтвердить свой выбор кнопкой ОК, после этого в папке References появятся указанные файлы. Проект готов для разработки скриптов или индикаторов.
Существующие в программе шаблонные файлы MainForm.cs и Program.cs можно удалить.

Отладка скрипта
Пользовательские индикаторы должны быть скопированы в папку «Handlers» в папке, где установлена программа. Если папки «Handlers» нет, её необходимо создать.
Созданный Пользователем скрипт можно запустить в режиме отладки в программе TSLab. Для этого в настройках программы должен быть активизирован режим отладки. Пользователь должен запустить Debug в SharpDevelop ( Debug — Run или F5), через некоторое время откроется программа TSLab. Затем Пользователь может создать скрипт в окне «Управление скриптами» и перейти к его редактированию. В редакторе скриптов нужно создать блок Поставщик данных, блок Внешний скрипт, соединить их, соединить Поставщик данных с одной из шкал. Созданный файл необходимо добавить в блок Внешний скрипт, после чего можно начать изучение поведения скрипта и его оптимизацию. Сообщения о происходящих действиях будут отображаться в окне Output программы SharpDevelop. В зависимости от разработанного скрипта возможно добавление дополнительных блоков в редакторе.
Для остановки отладки нужно нажать Debug — Stop Process, если Пользователь намеревается закрыть программу TSLab, или Debug — Detach — для отключения отладчика от процесса TSLab.

Пример скрипта.

Отладка технического индикатора
Для отладки индикатора необходимо скомпилировать его в папку с файлами TSLab. Для этого в настройках проекта (Properties) нужно перейти на вкладку Compiling и указать папку программы в Intermediate Output Path.

Внимание!
Программа ищет пользовательские индикаторы не в одной папке, а в двух.
Первая папка «Handlers» находится в той папке, где установлена программа. Использование этой папки нежелательно на Windows XP и недопустимо на Windows Vista и Windows 7.
Вторая папка находится:
Windows XP
«C:\Documents and Settings\YOUR_ACCOUNT\Local Settings\Application Data\TSLab\TSLab\Handlers»
Windows Vista и Windows 7
«C:\Users\YOUR_ACCOUNT\AppData\Local\TSLab\TSLab\Handlers»
Если папки по умолчанию нет, её нужно создать.
Далее нужно воспользоваться горячей клавишей F8 или Build — Build Solution для запуска компилятора. Теперь если в TSLab открыть Редактор графиков, то новый индикатор появится среди существующих пользовательских индикаторов.
Положение индикатора во вкладках определяется параметром
в файле C#, в строке:
+++++++++

namespace MyIndicators {
[HandlerCategory(«MyIndicators»)] …
+++++++++
Если параметр не указан явно, индикатор появится на вкладке «Пользовательские».
Для запуска процесса отладки в SharpDevelop нужно выбрать пункт меню Debug — Attach to Process…, далее в открывшемся окне нужно выделить процесс программы TSLab и нажать Attach. С этого момента все сообщения отладчика будут появляться в окне Output. Для остановки процесса необходимо выбрать Debug — Detach.
Пример технического индикатора