Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Заполнение таблицы вручную

При ручном заполнении структура таблицы и её содержимое задаются полностью через скрипт — с помощью функций компонента Таблица: модель данных.

Таблица: модель данных — невизуальный компонент: он хранит структуру и содержимое таблицы, но сам ничего не отображает на экранной форме. Чтобы увидеть данные, потребуется настроить визуальную таблицу. Подробнее см. раздел Визуализация таблицы.

Перед началом добавьте на экранную форму компонент Таблица: модель данных дочерним компоненту Таблица. В редакторе свойств объекта Таблица укажите ссылку на добавленный объект модели данных: нажмите правой кнопкой мыши по свойству Модель данных → Сослаться → TableModel_1.

Добавление столбцов

Добавьте столбцы с помощью функции AddColumn. Для каждого столбца укажите идентификатор, заголовок и тип данных:

Table_1.TableModel_1.AddColumn("name",  "Название",  "", "", "string",  false, false);
Table_1.TableModel_1.AddColumn("value", "Значение",  "", "", "float",   false, true);
Table_1.TableModel_1.AddColumn("unit",  "Ед. изм.", "", "", "string",  false, true);

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

Добавление строк

Добавьте нужное количество строк с помощью функции AddRow:

Table_1.TableModel_1.AddRow();
Table_1.TableModel_1.AddRow();
Table_1.TableModel_1.AddRow();

Чтобы вставить строку в определённую позицию, используйте InsertRow, передав номер строки, после которой будет вставлена новая:

Table_1.TableModel_1.InsertRow(0); // вставить строку после первой

Заполнение ячеек

Заполните ячейки данными с помощью функции SetCellData. Строки и столбцы нумеруются с 0:

Table_1.TableModel_1.SetCellData(0, 0, "Датчик температуры");
Table_1.TableModel_1.SetCellData(0, 1, 36.6);
Table_1.TableModel_1.SetCellData(0, 2, "°C");

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

Если нужно заполнить строку целиком, используйте SetRowDataAsJson:

Table_1.TableModel_1.SetRowDataAsJson(0, '{"name":"Датчик температуры","value":36.6,"unit":"°C"}');

Очистка содержимого таблицы

Для удаления строк используйте RemoveRow(одна строка) или RemoveRows(диапазон):

Table_1.TableModel_1.RemoveRow(0);       // удалить первую строку
Table_1.TableModel_1.RemoveRows(1, 3);   // удалить строки с 1 по 3

Чтобы полностью очистить таблицу от данных, не затрагивая структуру столбцов, используйте Clear:

Table_1.TableModel_1.Clear();

Чтобы сбросить таблицу полностью (удалить все строки и столбцы), используйте Reset:

Table_1.TableModel_1.Reset();