Структура электронной таблицы

Табличный документ имеет более простую структуру, чем текстовый документ, большинство элементов электронной таблицы вложены в элемент рабочего листа со всеми остальными элементами, размещенными на нем.

Ячейкам могут быть присвоены различные значения, некоторые свойства текста ячейки также могут быть изменены.

Элемент диапазона может содержать области и комментарии.

Некоторые нарисованные объекты — изображения, фигуры, диаграммы — можно размещать прямо на рабочем листе.

Текст, не относящийся к значениям ячеек, может быть сгруппирован в абзацы и добавлен к фигурам. Для удобства (поскольку всегда легче работать с маленькими блоками, чем с большими) текст обычно делится на небольшие фрагменты текста, называемые прогонами. Каждый абзац может состоять как из одного прогона текста, так и иметь внутри десятки, в зависимости от сложности абзаца.

Создание новой электронной таблицы

Простейший пример электронной таблицы с листом с именем «лист 1», первым столбцом шириной 140 пикселей и ячейкой A1 со значением «Новая ячейка» можно построить с помощью Документ Конструктора, используя следующий код:

builder.CreateFile("xlsx");                      // create a spreadsheet file in the .xlsx format
var oWorksheet = Api.GetActiveSheet();           // create a new 'oWorksheet' variable and get the created spreadsheet contents
oWorksheet.SetName("sheet 1");                   // set the 'sheet 1' name for the current active sheet
oWorksheet.SetColumnWidth(0, 20);                // set the width of the first column to 140 pixels
oWorksheet.GetRange("A1").SetValue("New cell");  // set the 'New cell' value to the A1 spreadsheet cell
builder.SaveFile("xlsx", "example.xlsx");        // save the resulting spreadsheet as a file in the .xlsx format with a new 'example.xlsx' name
builder.CloseFile();                             // close the spreadsheet file and finish work

Открытие существующей электронной таблицы

Если вы хотите отредактировать уже существующую электронную таблицу, вы можете открыть ее с помощью Документ Конструктора, получить ее элементы и изменить их по своему усмотрению. Единственным отличием от табличного редактора в данном случае будет то, что этот табличный редактор вам не понадобится. Электронная таблица открывается следующим образом:

builder.OpenFile("https://example.com/myspreadsheet.xlsx");          // use a path to an existing 'myspreadsheet.xlsx' spreadsheet file to open
var oWorksheet = Api.GetActiveSheet();           // create a new 'oWorksheet' variable and get the created spreadsheet contents
oWorksheet.SetName("sheet 1 renamed");           // set the 'sheet 1 renamed' name for the current active sheet
oWorksheet.SetColumnWidth(0, 20);                // set the width of the first column to 140 pixels
oWorksheet.GetRange("A1").SetValue("New cell");  // set the 'New cell' value to the A1 spreadsheet cell
builder.SaveFile("xlsx", "example.xlsx");        // save the resulting spreadsheet as a file in the .xlsx format with a new 'example.xlsx' name
builder.CloseFile();                             // close the spreadsheet file and finish work

Как видите, вам просто нужно использовать builder.OpenFile(); метод класса CDocBuilder с путем к нужной таблице в качестве аргумента для ее открытия. В приведенном выше примере мы открываем электронную таблицу myspreadsheet.xlsx, получаем ее первый лист и меняем имя листа, ширину первого столбца и вводим новое значение в его ячейку A1. Таким же образом можно изменить любой другой элемент электронной таблицы.

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