Метод ЭЛЕКТРОННАЯ_ТАБЛИЦА. УСТ_ЗНАЧ_ЯЧЕЙКИ
Метод УСТ_ЗНАЧ_ЯЧЕЙКИ – основное средство записи данных электронной таблицы. Ячейка, для которой выполняется запись, должна быть предварительно выбрана вызовом метода УСТ_ТЕК_ПОЗ или УСТ_ТЕК_ЯЧЕЙКУ. Если текущая ячейка попадает в область, указанную при вызове метода СОЗДАТЬ_БУФЕР, то запись значения выполняется в буфер, что радикально увеличивает скорость. При использовании буфера записи значение записывается в ячейку электронной таблицы во время вызова метода ЗАПИСАТЬ_БУФЕР.
ФУНКЦИЯ ЛОГИКА: УСТ_ЗНАЧ_ЯЧЕЙКИ(СТРОКА: тип; *<СТРОКА,ЧИСЛО,ЦЕЛОЕ,ЛОГИКА,ДАТА,ВРЕМЯ,ДАТА_ВРЕМЯ>: знач; ЛОГИКА: уст_формат = ДА)
Параметры
- тип
- Константа из набора ЭТ_...
- знач
- Значение для записи в ячейку. Тип значения должен соответствовать константе, указанной в параметре тип. Для записи формулы (ЭТ_ФОРМУЛА) необходимо предоставить строковое значение. Запись формул всегда выполняется в обход буфера.
- уст_формат
- Признак установки стандартного формата ячейки, соответствующего константе, указанной в параметре тип. Если необходимо установить для ячейки специальный формат, то надо указать значение параметра НЕТ, а затем вызвать метод УСТ_ФОРМАТ_ЯЧЕЙКИ с требуемой строкой формата.
Возвращаемое значение
ДА – в случае успешной записи, НЕТ – в случае ошибки. Сообщение об ошибке может быть получено с помощью метода ПОСЛ_ОШИБКА.
Замечание
Буфер записи накапливает как значения ячеек, так и форматы. Поэтому, как установка стандартных форматов (уст_формат = ДА), так и вызовы метода УСТ_ФОРМАТ_ЯЧЕЙКИ, будут в равной степени эффективны.
Пример
ПЕРЕМ ЭЛЕКТРОННАЯ_ТАБЛИЦА: т
ЕСЛИ т.СОЗДАТЬ_ДОК("Default") ТО
т.УСТ_ТЕК_ЛИСТ(т.ИМЯ_ЛИСТА(1))
ЦИКЛ ДЛЯ (стр = 1, 100)
т.УСТ_ТЕК_ЯЧЕЙКУ("A", стр) // выбираем ячейку в столбце "A"
т.УСТ_ЗНАЧ_ЯЧЕЙКИ(ЭТ_ЦЕЛОЕ, стр) // записываем номер строки как целое
т.УСТ_ТЕК_ЯЧЕЙКУ("B", стр) // выбираем ячейку в столбце "B"
т.УСТ_ЗНАЧ_ЯЧЕЙКИ(ЭТ_СТРОКА, СУММАП(стр)) // записываем номер строки прописью как строку
т.УСТ_ТЕК_ЯЧЕЙКУ("C", стр) // выбираем ячейку в столбце "C"
т.УСТ_ЗНАЧ_ЯЧЕЙКИ(ЭТ_ДАТА, ДАТА_ТЕК + стр, НЕТ) // записываем дату без формата
т.УСТ_ФОРМАТ_ЯЧЕЙКИ(ЭТ_ДАТА, "YYYY-MM-DD") // нестандартный формат для даты
КОНЕЦ_ЦИКЛА
т.СОХРАНИТЬ_ДОК("test.ods")
КОНЕЦ_ЕСЛИ