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