«updateLine»

Находит столбцы по ключевым значениям и заменяет определенные значения в строке.

Краткое описание

1)
setValue (string shape, «updateLine», int n, string keyName1, <type1> keyValue1 [, string keyName2, <type2> keyValue2 …] string reName1, <type1> reValue1 [, string reName2, <type2> reValue2 …][, 0, int rowFontType]);
shape.updateLine (int n, string keyName1, <type1> keyValue1 [, string keyName2, <type2> keyValue2 …] string reName1, <type1> reValue1 [, string reName2, <type2> reValue2 …][, 0, int rowFontType]);
2)
setValue (string shape, «updateLine», int n, string keyName1, <dyn_type1> keyValue1 [, string keyName2, <dyn_type2> keyValue2 …] string reName1, <dyn_type1> reValue1 [, string reName2, <dyn_type2> reValue2 …][, 0, int rowFontType]);
shape.updateLine (int n, string keyName1, <dyn_type1> keyValue1 [, string keyName2, <dyn_type2> keyValue2 …] string reName1, <dyn_type1> reValue1 [, string reName2, <dyn_type2> reValue2 …][, 0, int rowFontType]);

Parameters (Параметры)

ПараметрОписание
shapeИмя объекта
nКоличество ключей
keyName1Имя ключевого столбца
keyValue1Ключевое значение (type/dyn_type any)
reName1Имя столбца в котором будет производиться замена
reValue1Новое значение (type/dyn_type any)
rowFontTypeТип шрифта. Доступны 4 типа шрифта:
 
0 = Обычный (по умолчанию)
1 = Полужирный
2 = Курсив
3 = Полужирный курсив

Описание

Функция используется для замены отдельных значений столбца в верхней строке, в которой определенные ключевые столбцы содержат указанные ключевые значения Возможно задать столько ключей, сколько необходимо, при этом их количество должно быть указано параметром «n». Для столбцов можно указывать отдельные значения и массивы данных цвета (см. «appendLines»). При удовлетворении всех ключевых условий, столбцы, в которых производится замена, будут заполнены соответствующими значениями.
При отсутствии строк с соответствующими ключами, в таблицу добавляется строка в зависимости от установленных параметров. Параметр «rowFontType» позволяет определить тип шрифта отдельной строки.
ПРИМЕЧАНИЕ
В столбцах, отмеченных как «ключевые», значения невозможно изменить. При возникновении такого случая в таблицу будет добавлена новая строка с указанными параметрами.
IconПРИМЕР  
На примере ниже, при нахождении текста «Miller» в столбце «Surname», содержимое ячейки той же строки в столбце «Salary» будет изменено на 12000.
main()
{
   TABLE1.updateLine(1, «Surname», «Miller», «Salary», 12000);
}

Используется для объекта

Таблица

См. также

«updateLines», «appendLines»«insertLineN»«rowFontType»

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *