Метод ЭЛЕКТРОННАЯ_ТАБЛИЦА. УСТ_ФОРМАТ_ЯЧЕЙКИ
Метод УСТ_ФОРМАТ_ЯЧЕЙКИ позволяет установить стандартный или произвольный формат ячейки. Ячейка, для которой выполняется установка формата, должна быть предварительно выбрана вызовом метода УСТ_ТЕК_ПОЗ или УСТ_ТЕК_ЯЧЕЙКУ. Если текущая ячейка попадает в область, указанную при вызове метода СОЗДАТЬ_БУФЕР, то запись формата выполняется в буфер, что радикально увеличивает скорость. При использовании буфера записи формат применяется к ячейкам электронной таблицы во время вызова метода ЗАПИСАТЬ_БУФЕР.
ФУНКЦИЯ ЛОГИКА: УСТ_ФОРМАТ_ЯЧЕЙКИ(СТРОКА: тип; СТРОКА: формат; ЛОГИКА: локал = НЕТ)
Параметры
- тип
- Константа из набора ЭТ_... Задает стандартный формат для типа, если параметр формат равен пустой строке. Иначе описывает семейство формата. Для установки общего/стандартного формата указывается значение ЭТ_ПУСТО.
- формат
- Строка специального формата. Синтаксис строки формата в общем случае зависит от вида электронной таблицы (Excel или OOo Calc). Некоторые форматы, тем не менее, обозначаются одинаково. Например, "@" – обозначает текстовый формат, "0.00" – числовой с 2-мя знаками после запятой.
- локал
- НЕТ – строка формата задается в английском варианте, например "#,##0.00". ДА – строка формата задается в локализованном варианте, например "# ##0,00" для русского языка.
Возвращаемое значение
ДА – в случае успешного считывания, НЕТ – в случае ошибки. Сообщение об ошибке может быть получено с помощью метода ПОСЛ_ОШИБКА.
Замечание
Для установки стандартных форматов можно пользоваться методом УСТ_ЗНАЧ_ЯЧЕЙКИ с параметром уст_формат = ДА (по умолчанию).
Пример
ПЕРЕМ ЭЛЕКТРОННАЯ_ТАБЛИЦА: т
//...
т.УСТ_ТЕК_ЯЧЕЙКУ("A", 1)
т.УСТ_ФОРМАТ_ЯЧЕЙКИ(ЭТ_ЧИСЛО, "0,0000") // число с 4-мя знаками после запятой
т.УСТ_ЗНАЧ_ЯЧЕЙКИ(ЭТ_ЧИСЛО, 123.4567, НЕТ) // не перезаписываем формат