Перечисление CellFormat

По умолчанию при создании документа всем ячейкам присваивается формат «Общий». Полный список форматов представлен в таблице. Перечисление CellFormat используется в методах Cell::getFormat() и Cell::setFormat(), а также в поле PivotTableValueField.cellNumberFormat.

Значение	Описание
CellFormat::General	Формат ячейки «Общий». В этом формате в ячейке отображаются первые 9 символов числа, остальные доступны для просмотра в строке формул. Для дробных чисел в формате «Общий» незначащие нули в дробной части не отображаются. Числа, состоящие более чем из 12 символов, переводятся в экспоненциальную форму после завершения ввода в ячейку.
CellFormat::Percentage	Формат ячейки «Процентный». Этот формат используется для представления чисел как процентов. При применении формата «Процентный» введенное число умножается на 100 и обозначается знаком «%».
CellFormat::Number	Формат ячейки «Числовой». Если в ячейке с форматом «Числовой» содержится дробное число, то можно указать количество знаков, отображаемых в данном числе после разделителя.
CellFormat::Text	Формат ячейки «Текстовый».
CellFormat::Currency	Формат ячейки «Денежный». Этот формат используется для представления чисел со знаком или кодом валюты.
CellFormat::Accounting	Формат ячейки «Финансовый». Этот формат применяется для чисел, используемых в бухгалтерских документах. В формате «Финансовый» введенное число автоматически дополняется названием валюты, которая соответствует настройкам системы компьютера. Отрицательные числа в формате «Финансовый» заключаются в круглые скобки в ячейке, а в строке формул остаются в том виде, в котором они были введены.
CellFormat::Date	Формат ячейки «Дата». Этот формат автоматически присваивается числам, введенным в определенном виде, например, ДД.ММ.ГГГГ.
CellFormat::Time	Формат ячейки «Время». Этот формат автоматически присваивается числам, введенным в определенном виде, например, ЧЧ:ММ. Время».
CellFormat::DateTime	Формат ячейки «Дата + Время»
CellFormat::Fraction	Формат ячейки «Дробный». Этот формат используется для представления дробных чисел в виде обыкновенных дробей (то есть дробная часть заменяется на числитель и знаменатель).
CellFormat::Scientific	Формат ячейки «Экспоненциальный». Экспоненциальный (или научный) формат используется для представления больших чисел в короткой форме. Все введенные числа длиной более 12 символов автоматически переводятся в этот формат. В ячейке число в формате «Экспоненциальный» представлено следующим образом: - целая часть, всегда состоящая из одной цифры; - разделитель целой и дробной части; - дробная часть, по умолчанию состоящая из двух цифр; - показатель степени числа 10 в виде E<знак показателя степени> <показатель степени>.
CellFormat::Custom	Пользовательский формат.

Использование данных констант позволяет установить выбранный формат. При этом будет использованы параметры формата по умолчанию.

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

 Table firstSheet = document.getBlocks().getTable("Лист1").get();
 Cell cell = firstSheet.getCell("B1");
 cell.setFormat(CellFormat::General);
 Cell cell = firstSheet.getCell("B2");
 cell.setFormat(CellFormat::Percentage);
 Cell cell = firstSheet.getCell("B3");
 cell.setFormat(CellFormat::Number);

Результат

Пример форматирования ячейки также приведен в разделе, описывающем установку значений ячеек.