Робота з управлінням таблицями

Робота з управлінням таблицями

Робота з управлінням таблицями

У. 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 класу висвітлює властивості відображення та захисту. Використовуйте їх для налаштування видимості листів, дисплея сітки, зому і кольору вкладки.

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 допомагають користувачам візуально відрізняти таблиці.

Загальні питання

IssueCauseВиправлення
Файл не знайдений під час завантаженняНеправильний шляхВикористовувати абсолютний шлях або перевірку робочого каталогу
Збіг імен листівДублюються імена при додаванні листів.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)Відкриває таблицю

See Also

 Українська