Alpha.Community

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

Функции

Configure

void Configure(string json)

Переопределяет столбцы таблицы, сформированной с помощью функции ConfigureByModel() на основе модели данных.

В качестве входного параметра json следует указать JSON-строку, описывающую переопределенную модель таблицы в следующем формате:

{
 'columns': [
  { 'id': <идентификатор>,
   'title': <заголовок>,
   'description': <описание>,
   'width': <ширина: int4>,
   'wordWrap': <разрешить перенос слов: bool>,
   'numberFormat': <числовой формат: string>,
   'hidden': <скрывать: bool>,
   'textAlignment': <Выравнивания текста в ячейке: int4>,
   'titleTextAlignment': <Выравнивания текста в заголовке столбца: int4>,
   'dataType': <тип данных: string>,
   'values': <массив значений для выпадающего списка>,
   'editorType': <тип редактора: 0 - текстовый, 1 - выпадающий список, 2 - флаг, 3 – целого числа, 4 – даты и времени, 5 – даты, 6 – времени>
   'isReadOnly': <только для чтения: bool>,
   'oneClickEditing': <открытие редактора одинарным кликом по ячейке: bool>,
  }
 ]
}

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

Пусть в соответствии с моделью данных определена таблица с четырьмя столбцами, имеющими следующие названия столбцов (названия столбцов при этом совпадают с идентификаторами столбцов):

type value readOnly data
... ... ... ...

В новой модели следует изменить названия столбцов на русскоязычные, а один из столбцов – data – скрыть. Тогда можно определить JSON-объект, переопределяющий модель данных, и затем передать его в качестве входного параметра функции. Ознакомьтесь с примером такого кода, написанным на языке JavaScript:

var config = {
 'columns': [
  { 'id': "type", 'title': "Тип данных"  },
  { 'id': "value", 'title': "Значение" },
  { 'id': "readOnly", 'title': "Только для чтения" },
  { 'id': "data", 'hidden': true }
 ]
}
EditableTable.Configure(JSON.stringify(config));

ConfigureByModel

void ConfigureByModel()

Строит визуальную таблицу в соответствии с моделью данных, указанной в свойстве Модель данных (TableModel).

InsertRowAfterSelection

int4 InsertRowAfterSelection()

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

RemoveRows

void RemoveRows(string rows)

Удаляет строки таблицы.

В качестве входного параметра rows следует указать массив номеров строк, которые должны быть удалены. При этом удалить строки можно только в случае, если это разрешено свойством Возможность удаления строк (CanDeleteRows).

StartEditCell

void StartEditCell(string json)

Запускает редактирование значения ячейки.

В качестве входного параметра json следует указать JSON-строку, описывающую параметры редактирования ячейки, в следующем формате:

{
 'row': <номер строки>,
 'column': <номер столбца>,
 'dataType': <тип данных>,
 'value': <редактируемое значение>,
 'values': <массив значений для выпадающего списка>,
 'editorType': <тип редактора>
}

Поля row и column обязательны. Остальные указываются в зависимости от задачи. Подробнее об этом – в описании свойства-ссылки Начать редактирование (pStartEdit).

GetViewSettings

string GetViewSettings()

Возвращает json-строку, содержащую информацию о внешнем виде таблицы.

Под внешним видом на данный момент подразумевается только ширина столбцов.

Пример возвращаемого значения:

{"Columns":{"column0":{"Width":100}}}

UpdateView

void UpdateView(string json)

Применяет указанные настройки внешнего вида таблицы.

Под внешним видом на данный момент подразумевается только ширина столбцов.

В качестве входного параметра json следует указать JSON-строку, описывающую настройки внешнего вида таблицы в следующем формате:

{
 'Columns': {
  '<id столбца>': {
   'Width':<новая ширина столбца>
  }
 }
}