CellValue: Object;
Свойство CellValue определяет значение ячейки таблицы.
Значение свойства устанавливается с помощью метода setCellValue и возвращается при помощи метода getCellValue. Из JSON значение свойства задать нельзя.
При вызове метода setCellValue указываются следующие параметры: value - новое значение ячейки, rowIndex - индекс строки ячейки, colIndex - индекс столбца ячейки, fireEvent - признак генерации события, animate - признак воспроизведения анимации.
При вызове метода getCellValue указываются следующие параметры: rowIndex - индекс строки ячейки, colIndex - индекс столбца ячейки.
Для выполнения примера необходимо наличие на html-странице компонента TabSheet с наименованием «tabSheet» (см. «Пример создания компонента TabSheet»). Отключим перерисовку таблицы, установим новое значение ячейки, после чего включим перерисовку таблицы. Получим диапазон ячеек по строке и преобразуем его в формат табличной верстки, выведем индекс столбца по тексту его заголовка, получим координаты ячейки по строке и выведем их. Сделаем неактивными элементы горизонтальной и вертикальной прокрутки, выведем признак отрисовки компонента в асинхронном режиме и признак редактирования ячеек. Сделаем неактивной таблицу стилей. Выведем признаки наличия группировок и объектов в таблице:
// Отключим перерисовку таблицы
tabSheet.beginUpdate();
// Установим значение ячейки
tabSheet.setCellValue(50, 1, 1, true);
// Включим перерисовку таблицы
tabSheet.endUpdate();
// Получим диапазон ячеек по строке
var range = tabSheet.getRangeFromString("A0:A0");
// Преобразуем диапазон ячеек в текст в формате табличной верстки и выведем его
var formattedRange = tabSheet.convertToExcelFormat(range);
console.log("Результат преобразования диапазона: " + formattedRange);
// Получим и выведем индекс столбца по тексту его заголовка
var index = tabSheet.getColIndexByHeaderText("C");
console.log("Индекс столбца с заголовком 'C': " + index);
// Получим и выведем координаты ячейки
var coord = tabSheet.getCoordFromString("A1");
console.log("Координаты ячейки A1: (" + coord.colIndex + ", " + coord.rowIndex + ")");
// Сделаем неактивными элементы горизонтальной и вертикальной прокрутки
tabSheet.getHScrollBar().setEnabled(false);
tabSheet.getVScrollBar().setEnabled(false);
// Выведем признак отрисовки компонента в асинхронном режиме
console.log("Признак отрисовки компонента в асинхронном режиме: " + tabSheet.getIsAsyncScrolling());
// Выведем признак редактирования ячеек
console.log("Признак редактирования ячеек: " + tabSheet.getIsEditing());
// Сделаем неактивной таблицу стилей
tabSheet.getStyleSheet().disabled = true;
// Выведем признак наличия группировок в таблице
console.log("Признак наличия группировок в таблице: " + tabSheet.IsTabSheetExpandExist());
// Выведем признак наличия объектов в таблице
console.log("Признак наличия объектов в таблице: " + tabSheet.IsTabSheetTabObjectExist());
В результате выполнения примера было изменено значение указанной ячейки, элементы горизонтальной и вертикальной прокрутки стали неактивными, была отключена таблица стилей:
Также в консоли браузера были выведены следующие значения: результат преобразования диапазона ячеек в текст в формате табличной верстки, индекс столбца с указанным заголовком, координаты полученной ячейки, признак отрисовки компонента в асинхронном режиме, признак редактирования ячеек, признаки наличия группировок и объектов в таблице:
Результат преобразования диапазона: <table><tr><td style='background-color: #D2DFEE; font-family: Arial; font-size: 10.67px; color: #000000; text-decoration: underline ; vertical-align: top; text-align: left; word-wrap: break-word; padding: 5px 0px 5px 5px; '>16905</td></tr></table>
Индекс столбца с заголовком 'C': 2
Координаты ячейки A1: (0, 1)
Признак отрисовки компонента в асинхронном режиме: false
Признак редактирования ячеек: false
Признак наличия группировок в таблице: true
Признак наличия объектов в таблице: true
См. также: