Функции для работы с программируемой таблицей

Следующий набор функций оперирует только с таблицей «OWN», создаваемой при расчете программы.  Данная таблица доступна не только для чтения с помощью стандартных функции «GET_ITEM» и «GET_NUMBER_OF», но также и для модификации с помощью следующих функций.

ADD_ITEM

Данная функция вставляет строку с индексом «Index» в таблицу «OWN».  Ассоциативный массив «table_string» используется для инициализации колонок таблицы значениями.  «Table_string» должен содержать элементы с ключами равными названиям колонок.

ADD_ITEM (DOUBLE Index, MAP table_string)

MODIFY_ITEM

Функция модифицирует уже существующую строку с индексом «Index» с помощью массива «table_string».

MODIFY_ITEM (DOUBLE Index, MAP table_string)

DELETE_ITEM

Функция предназначена для удаления строки с индексом «Index».

DELETE_ITEM (DOUBLE Index)

DELETE_ALL_ITEMS

Функция полностью очищает таблицу «OWN».

DELETE_ALL_ITEMS()

Параметры:

№	Параметр	Тип	Описание
1	INDEX	DOUBLE	Индекс для обращения к коллекции. Должен содержать целочисленное значение
2	TABLE_STRING	MAP	Массив, содержащий значения для колонок модифицируемой строки

Пример:

‘
st=CREATE_MAP()
st=SET_VALUE(st,"Value",10)
ADD_ITEM(1,st)
st=GET_ITEM ("OWN",1)
value=GET_VALUE(st,"Value")
DELETE_ALL_ITEMS()
 ‘

Данный пример может работать только с таблицей, содержащей единственную колонку с именем «Value». Сначала создается массив, содержащий элемент со значением «10» и ключом «Value». Затем, в таблице создается строка с индексом «1» и значением колонки «Value» равным «10». В дальнейшем строка с индексом «1» считывается обратно в массив и значение элемента с ключом «Value» попадает в переменную «value». И, наконец, все строки таблицы удаляются вызовом «DELETE_ALL_ITEMS()».

SET_ROW_COLOR

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

SET_ROW_COLOR (STRING client_code, STRING background_color, STRING selected_background_color)

Параметры:

№	Параметр	Тип	Описание
1	CLIENT_CODE	STRING	Код клиента, при установке этого параметра в «ROWNAME» цвет подсветки устанавливается на текущего рассчитываемого клиента.
2	BACKGROUND_COLOR	STRING	Основной цвет подсветки строки
3	SELECTED_BACKGROUND_COLOR	STRING	Цвет подсветки строки, когда строка выделена

Цвет фона (подсветки) задается макросом «RGB(<red>, <green>, <blue>)». Например, если в качестве параметра цвета передадите в функцию строку «RGB(255, 0, 0)», то цвет подсветки установится в красный. Для использования системного цвета по умолчанию используйте строку «DEFAULT_COLOR».

Пример:

‘
SET_ROW_COLOR (ROWNAME, "RGB(0,255,0)", "DEFAULT_COLOR")
‘

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

SET_ROW_COLOR_EX

Функция назначения цвета фона и шрифта указанной строки таблицы.

SET_ROW_COLOR_EX (DOUBLE row_number, STRING background_color, STRING selected_background_color, STRING font_color, STRING selected_font_color)

Параметры:

Цвет фона (подсветки) задается макросом «RGB(<red>, <green>, <blue>)». Например, если в качестве параметра цвета передадите в функцию строку «RGB(255, 0, 0)», то цвет подсветки установится в красный. Для использования системного цвета по умолчанию используйте строку «DEFAULT_COLOR».

Пример:

‘
SET_ROW_COLOR_EX (10, "DEFAULT_COLOR", "DEFAULT_COLOR", "RGB(0,255,0)", "RGB(0,0,255)")
‘

Основной цвет шрифта для 10-й строки таблицы устанавливается в зеленый. При выделении её курсором цвет шрифта станет синим.