Skip to main content

Метод Cell:setFormat

Метод устанавливает формат ячейки. Существуют несколько вариантов использования метода.

Варианты вызова метода​


 setFormat(cellFormat)

Где cellFormat – формат ячейки типа DocumentAPI.CellFormat.


 setFormat(accountingCellFormatting)

Где accountingCellFormatting – формат ячейки типа DocumentAPI.AccountingCellFormatting.


 setFormat(percentageCellFormatting)

Где percentageCellFormatting – формат ячейки типа DocumentAPI.PercentageCellFormatting.


 setFormat(numberCellFormatting)

Где numberCellFormatting – формат ячейки типа DocumentAPI.NumberCellFormatting.


 setFormat(currencyCellFormatting)

Где currencyCellFormatting – формат ячейки типа DocumentAPI.CurrencyCellFormatting.


 setFormat(dateTimeCellFormatting, typeFormat)

Где dateTimeCellFormatting – формат ячейки типа DocumentAPI.DateTimeCellFormatting, typeFormat - формат даты/времени типа DocumentAPI.CellFormat.


 setFormat(fractionCellFormatting)

Где fractionCellFormatting – формат ячейки типа DocumentAPI.FractionCellFormatting.


 setFormat(scientificCellFormatting)

Где scientificCellFormatting – формат ячейки типа DocumentAPI.ScientificCellFormatting.

Примеры использования​


 local tbl = document:getBlocks():getTable(0)
 local cellA1 = tbl:getCell("A1")
 
 cellA1:setNumber(2.3)
 
 -- Формат: Общий
 cellA1:setFormat(DocumentAPI.CellFormat_General)
 print("Формат Общий: ", cellA1:getFormat()) -- 0
 print("Значение ячейки: ", cellA1:getRange():extractText()) -- 2,3
 
 -- Формат: Процентный
 local a1CellFormatting = DocumentAPI.PercentageCellFormatting()
 a1CellFormatting.decimalPlaces = 1
 cellA1:setFormat(a1CellFormatting)
 print("Формат Процентный: ", cellA1:getFormat()) -- 1
 print("Значение ячейки: ", cellA1:getRange():extractText()) -- 230,0%
 
 -- Формат: Числовой
 a1CellFormatting = DocumentAPI.NumberCellFormatting()
 a1CellFormatting.decimalPlaces = 2
 cellA1:setFormat(a1CellFormatting)
 print("Формат Числовой: ", cellA1:getFormat()) -- 2
 print("Значение ячейки: ", cellA1:getRange():extractText()) -- 2,30
 
 -- Формат: Денежный
 a1CellFormatting = DocumentAPI.CurrencyCellFormatting()
 a1CellFormatting.symbol = '$'
 cellA1:setFormat(a1CellFormatting)
 print("Формат Денежный: ", cellA1:getFormat()) -- 4
 print("Значение ячейки: ", cellA1:getRange():extractText()) -- 2,30$
 
 -- Формат: Финансовый
 a1CellFormatting = DocumentAPI.AccountingCellFormatting()
 a1CellFormatting.symbol = '₽'
 cellA1:setFormat(a1CellFormatting)
 print("Формат Финансовый: ", cellA1:getFormat()) -- 5
 print("Значение ячейки: ", cellA1:getRange():extractText()) -- 2,30₽
 
 -- Формат: Дата / Время
 a1CellFormatting = DocumentAPI.DateTimeCellFormatting()
 a1CellFormatting.dateListID = DocumentAPI.DatePatterns_FullDate
 a1CellFormatting.timeListID = DocumentAPI.TimePatterns_ShortTime
 cellA1:setFormat(a1CellFormatting)
 print("Формат Дата / Время: ", cellA1:getFormat()) -- 8
 print("Значение ячейки: ", cellA1:getRange():extractText()) -- понедельник, 1 января 1900 г. 7:12
 
 -- Формат: Дробный
 a1CellFormatting = DocumentAPI.FractionCellFormatting()
 a1CellFormatting.minNumeratorDigits = 2
 cellA1:setFormat(a1CellFormatting)
 print("Формат Экспоненциальный: ", cellA1:getFormat()) -- 9
 print("Значение ячейки: ", cellA1:getRange():extractText()) -- 2 2/7
 
 -- Формат: Научный
 a1CellFormatting = DocumentAPI.ScientificCellFormatting()
 a1CellFormatting.decimalPlaces = 5
 cellA1:setFormat(a1CellFormatting)
 print("Формат Научный: ", cellA1:getFormat()) -- 10
 print("Значение ячейки: ", cellA1:getRange():extractText()) -- 2,30000E+00