Общие функции

Текущий раздел описывает функции, доступные в компонентах, основанных на компоненте Data Table.

Удалить строку

Удаляет строки из таблицы данных, указанные по индексам, указанным в аргументе Index.

Имя функции: removeRows

Аргументы:

Поле

Тип поля

Описание поля

Index

Data Table

Таблица данных с одним полем Index типа String. В каждой строке указывается индекс строки, которую необходимо удалить из таблицы данных.

Добавить строку

Вставляет таблицу данных, указанную в аргументе Row, в позицию индекса, указанную в аргументе Index.

Имя функции: addRow

Аргументы:

Поле

Тип поля

Описание поля

Index

Integer

Индекс строки, указывающий, куда необходимо добавить новую строку.

Row

Data Table

Таблица данных, содержащая данные для вставки в таблицу данных. Формат таблицы данных Row должен совпадать с форматом таблицы данных, в которую добавляется строка.

Сортировка разрешена

Удаляет строку, указанную индексом Index, и вставляет ее в позицию, указанную индексом After.

Имя функции: reorderRecord

Аргументы:

Поле

Тип поля

Описание поля

Index

String

Индекс строки, которая будет переупорядочена.

After

String

Позиция индекса для вставки строки.

Обновить ячейку

Обновляет ячейку, указанную аргументами Index и Field, значением, указанным аргументом Value.

Имя функции: updateCell

Аргументы:

Поле

Тип поля

Описание поля

Index

String

Индекс строки ячейки, которую необходимо обновить.

Field

String

Имя поля ячейки для обновления.

Value

Data Table

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

Тип данных поля value должен быть таким типом, который может быть приведен к типу обновляемой ячейки.

Следующий пример иллюстрирует один из способов вызова функции updateCell:

  • Рассмотрим компонент Таблица данных с именем dataTableComponent0, имеющий по крайней мере одну существующую строку и поле exampleField

  • Мы хотим обновить значение ячейки в первой строке поля exampleField со строкой “this is the new field value” («это новое значение поля»).

Выражение используется в привязке в контексте инструментальной панели, где находится dataTableComponent0:

{form/dataTableEditorUpdateCell:updateCell("1","exampleField",'array("value", "This is the new field value")')}

Выражение можно разбить на части следующим образом:

  • form/dataTableComponent0 — схема form/ обозначает компонент инструментальной панели, а dataTableComponent0 указывает на конкретный компонент

  • :updateCell Указывает, что функция updateCell вызывается из компонента

  • Функция имеет следующие аргументы:

    • "1" - строка таблицы данных для обновления

    • "exampleField" - поле таблицы данных для обновления

    • 'array("value", "This is the new field value")' Создает таблицу данных с одним полем value типа String и одну строку с данными "This is the new field value"

Запись выбрана

Выбирает строку в таблице данных.

Имя функции: rowSelected

Аргументы:

Поле

Тип поля

Описание поля

Selected Index

String

Указывает строку, которую необходимо выбрать в таблице данных.

Selection Type

Integer

Указывает тип выбора, который будет применен к строке.

Перезагрузить

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

Имя функции: reset

Аргументы:

None

Возвращает:

None

Was this page helpful?