| Добавляет несколько строк в таблицу. |
Краткое описание
| 1)setValue (string shape, «appendLines», int number [, string Name1, <dyn_anytype> Value1 [, string Name2, <dyn_anytype> Value2… [, 0, dyn_int rowFontType]]]);shape.appendLines (int number, [ string Name1, <dyn_anytype1> Value1 [, string Name2, <dyn_anytype2> Value2… [, 0, dyn_int rowFontType]]]); 2)setValue (string shape, «appendLines», int number [, string Name1, <dyn_dyn_anytype1> Value1 [, string Name2, <dyn_dyn_anytype2> Value2… [, 0, dyn_int rowFontType]]]);shape.appendLines (int number [, string Name1, <dyn_dyn_anytype1> Value1 [, string Name2, <dyn_dyn_anytype2> Value2… [, 0, dyn_int rowFontType]]]); |
Параметры
| Параметр | Описание |
| shape | Имя объекта |
| количество | Количество строк |
| Имя1 | Имя столбца |
| Value1 | Содержание столбца |
| rowFontType | Тип шрифта. Доступны 4 типа шрифта: 0 = Обычный (по умолчанию) 1 = Полужирный 2 = Курсив 3 = Полужирный курсив |
Описание
| Функция добавляет одну или несколько строк в конец таблицы. Различными опциями вызова функции можно определить наличие значений, значений и цветов, или отсутствие данных в строках. Значения записываются в виде динамических массивов «anytype». Если необходимо включить данные о цвете, следует использовать массив «dyn_dyn_anytype». Аргумент массива «dyn_anytype» содержит три элемента: |
| dyn_dyn_anytype[<anytype> Value[<string> bCol [<string> fCol]] |
| «Value» — устанавливаемое значение, «bCol» — цвет фона «fCol» — цвет шрифта для ячейки. |
| Функция «appendLines» удаляет любое предыдущее выделение в таблице без учета порядка сортировки, т.е. ячейки добавляется в конец таблицы. Параметр «rowFontType» включает определение типа шрифта для отдельной строки. |
 ПРИМЕР |
| Пример для таблицы с именем «table». |
| 1. Добавление 4 пустых строк: |
| table.appendLines(4); |
| 2. Для вставки первых 5 значений из массива динамических строк «ds» в столбец «Names»: |
| table.appendLines(5,»Names»,ds); |
| 3. На примере ниже в столбце «Forename» и «Surname» добавляются три строки значений цвета. |
main()
{
shape table=getShape(«table123»);
dyn_string d1, d2, d3;
dyn_dyn_string fnam, snam;
// Записи в столбце «Forename»
d1=makeDynString(«Peter»,»green»,»red»);
d2=makeDynString(«Martin»,»[100,50,50]»,»[25,60,100]»);
d3=makeDynString(«Christian»,»[50,50,50]»,»red»);
// Преобразование в массив «dyn_dyn array»
fnam[1]=d1;
fnam[2]=d2;
fnam[3]=d3;
// Записи в столбце «Surname»
d1=makeDynString(«Baker»,»green»,»red»);
d2=makeDynString(«Miller»,»[100,50,50]»,»[25,60,100]»);
d3=makeDynString(«Smith»,»[50,50,50]»,»red»);
// Преобразование в массив «dyn_dyn array»
snam[1]=d1;
snam[2]=d2;
snam[3]=d3;
// Добавление трех строк
table.appendLines(3,»Forename»,fnam,»Surname»,snam);
}
| 4. На примере ниже в столбце «Names» таблицы «table234» вводятся 3 значения: |
| main() { shape table=getShape(«table234»); dyn_string tmp; tmp[1]=»Thomas»; tmp[2]=»Marc»; tmp[3]=»Peter»; table.appendLines(3, «Names», tmp); } |
Используется для объекта
| Таблица |
См. также