Tab.Fill

Fill (Изменение значений)
Объект: Таблица Статус разработки: Реализована Тип: Функция Обращение к БД: Нет Исключения: Неверное имя столбца, невозможно превратить в число, строку Визуальность: Нет

• Начальная страница
• Общее описание
• Объекты
• Таблица

Функция выполняет заполнение ячеек в указанном столбце таблицы для строк таблицы в указанном диапазоне указанным значением. Если указание на столбец отсутствует, функция заполняет все столбцы строк диапазона. Чтобы заполнить все ячейки таблицы определенным значением, можно использовать конструкцию aTab.Fill(<Значение>).

Синтаксис

Tab.Fill(<Значение для заполнения>,<Индекс начальной строки (INT)>,<Индекс конечной строки (INT)>,<Индекс или наименование столбца (INT,STRING)>)

Аргументы

• <Значение для заполнения> - Произвольное значение, которым необходимо заполнить ячейки таблицы.
• <Индекс начальной строки (INT)> - (необязательный аргумент) Индекс начальной строки диапазона заполнения. Если аргумент опущен, будет использована первая строка таблицы.
• <Индекс конечной строки (INT)> - (необязательный аргумент) Индекс конечной строки диапазона заполнения. Если аргумент опущен, будет использована последняя строка таблицы.
• <Индекс или наименование столбца (INT,STRING)> - (необязательный аргумент) Строковое значение аргумента задает наименование столбца, ячейки которого будут заполнены указанными значениями, числовое значение задает номер этого столбца (нумерация столбца происходит с единицы). Если аргумент не задан, заполнение производится по всем столбцам таблицы.

Примеры

//Создается и заполняется таблица значений
aTab:=Tab.Create("b1,b2,b3,b4");

aTab.AddLine("b1,b2,b3,b4",1,2,3,4);
aTab.AddLine("b1,b2,b3,b4",2,2,3,33);
aTab.AddLine("b1,b2,b3,b4",3,5,5,4);
aTab.AddLine("b1,b2,b3,b4",4,2,3,4);
aTab.AddLine("b1,b2,b3,b4",4,2,3,77);
aTab.AddLine("b1,b2,b3,b4",5,2,3,4);

//Заполняем 3 значения столбца b2 числом 11
aTab.Fill(11,3,5,"b2");

//Заполняем всю ячейки строки 5 значением 22
aTab.Fill(22,5,5);

aTab.Select();
While aTab.Next() Do
  Message(""+aTab.b1+"; "+aTab.b2+"; "+aTab.b3+"; "+aTab.b4);
EndDo;

//Будет выведено последовательно:
//"1; 2; 3; 4"
//"2; 2; 3; 33"
//"3; 11; 5; 4"
//"4; 11; 3; 4"
//"22; 22; 22; 22"
//"5; 2; 3; 4"