Работа с управлением электронными таблицами

В связи с этим Workbook class - это входная точка для всех операций с электронной таблицей в Aspose.Cells FOSS for C++. Она предоставляет методы создания новых рабочих книг, загрузки существующих файлов XLSX, управления рабочими листами и сохранения результата.

Создание нового учебника

Instantiate Workbook Для создания пустой рабочей книги автоматически создается стандартный лист.

#include "aspose/cells_foss/Workbook.h"
#include "aspose/cells_foss/Worksheet.h"

using namespace Aspose::Cells_FOSS;

int main() {
    Workbook workbook;
    Worksheet& sheet = workbook.GetWorksheets()[0];
    sheet.SetName("Summary");
    workbook.Save("output.xlsx");
    return 0;
}

Загрузка существующей книги

Передать путь файла в Workbook После загрузки, рабочие листы и данные ячейки доступны сразу.

Workbook workbook("existing.xlsx");
Worksheet& sheet = workbook.GetWorksheets()[0];
// Access or modify cells here
workbook.Save("modified.xlsx");

Конфигурирование свойств рабочего листа

В связи с этим Worksheet class раскрывает свойства отображения и защиты. Используйте их для настройки видимости листа, сетки, увеличения масштаба и цвета вкладки.

Worksheet& sheet = workbook.GetWorksheets()[0];
sheet.SetName("Data");
sheet.SetShowGridlines(false);
sheet.SetShowRowColumnHeaders(true);
sheet.SetZoom(80);

Защита и разоблачение рабочего листа

Call Worksheet::Protect блокировать лист от редактирования, и Worksheet::Unprotect снятие защиты:

sheet.Protect("password");
// ... distribute the workbook ...
sheet.Unprotect("password");

Обеспечение уникального листа и определённого объема названия

При программировании множества рабочих листов используйте: Workbook::EnsureUniqueSheetName для предотвращения столкновений имен. Workbook::EnsureValidDefinedNameScope подтвердить, что определённые имена правильно определены.

workbook.EnsureUniqueSheetName();
workbook.EnsureUniqueDefinedName();

Сохранение учебника

Call Workbook::Save(fileName) для записи рабочей книги на диск. Многочисленные перегрузки принимают имя файла, потоковую передачу или явное SaveFormat.

workbook.Save("products.xlsx");

Советы и лучшие практики

Всегда звони . Workbook::Dispose() когда это сделано с рабочей книгой, чтобы освободить не управляемые ресурсы.
Имена рабочих листов должны быть уникальными в рамках использования сборника . EnsureUniqueSheetName после добавления партий.
Набор Worksheet::SetShowGridlines(false) для листов в стиле презентации, чтобы улучшить читаемость.
Использование: Worksheet::SetZoom(value) настройка уровня увеличения по умолчанию (процент) для просмотра рабочих листов.
Цвета вкладки, присвоенные через: Worksheet::SetTabColor помогает пользователям визуально различать рабочие листы.

Общие проблемы

Issue	Cause	Устранить
Файл не найден при загрузке .	Неправильный путь	Использовать абсолютный путь или проверять рабочий каталог
Совпадение названия листа	Дублирование имен при добавлении листов	Call `EnsureUniqueSheetName()` после каждого добавления
Изменения в рабочем книге не сохранены	`Save` не вызванный	Всегда звони . `workbook.Save(path)` перед выходом
Предупреждение о утечке памяти	`Dispose` не вызванный	Call `workbook.Dispose()` в конце сферы применения

Справочное резюме API

Класс/метод	Description
`Workbook()`	Создает новую пустую рабочую книгу .
`Workbook(filePath)`	Загружает существующий файл XLSX
`Workbook::Save(fileName)`	Сохраняет сборник на диске .
`Workbook::EnsureUniqueSheetName()`	Устранение дублирующих имен листов .
`Workbook::Dispose()`	Выпускает ресурсы.
`Worksheet::SetName(name)`	Переименовать рабочий лист
`Worksheet::SetShowGridlines(bool)`	Переключает видимость линии сетки.
`Worksheet::SetZoom(percent)`	Установка процента по умолчанию увеличения
`Worksheet::Protect(password)`	Замыкает рабочий лист .
`Worksheet::Unprotect(password)`	Открывает рабочий лист .

Работа с управлением электронными таблицами