Práce se správou tabulek

Práce se správou tabulek

Třída Workbook je vstupním bodem pro všechny operace s tabulkami v Aspose.Cells FOSS pro C++. Poskytuje metody pro vytvoření nových sešitů, načtení existujících souborů XLSX, správu listů a uložení výsledku.

Vytvoření nového sešitu

Instanciujte Workbook pro vytvoření prázdného sešitu. Výchozí list je vytvořen automaticky.

#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;
}

Načtení existujícího sešitu

Předávejte cestu k souboru do konstruktoru Workbook pro načtení existujícího souboru XLSX. Po načtení jsou listy a data buněk okamžitě dostupné.

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

Konfigurace vlastností listu

Třída Worksheet zpřístupňuje vlastnosti zobrazení a ochrany. Použijte je k nastavení viditelnosti listu, zobrazení mřížky, zoomu a barvy záložky.

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

Ochrana a odemčení listu

Zavolejte Worksheet::Protect k uzamčení listu proti úpravám a Worksheet::Unprotect k odstranění ochrany:

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

Zajištění jedinečného listu a rozsahu definovaných názvů

Při programovém přidávání více listů použijte Workbook::EnsureUniqueSheetName k zamezení kolizí názvů. Použijte Workbook::EnsureValidDefinedNameScope k ověření, že definované názvy mají správný rozsah.

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

Ukládání sešitu

Zavolejte Workbook::Save(fileName) pro zápis sešitu na disk. Více přetížení akceptuje název souboru, proud nebo explicitní SaveFormat.

workbook.Save("products.xlsx");

Tipy a osvědčené postupy

• Vždy zavolejte Workbook::Dispose(), až budete hotovi s sešitem, abyste uvolnili neřízené prostředky.
• Názvy listů musí být v rámci sešitu jedinečné — použijte EnsureUniqueSheetName po hromadných přidáních.
• Nastavte Worksheet::SetShowGridlines(false) pro listy ve stylu prezentace, aby se zlepšila čitelnost.
• Použijte Worksheet::SetZoom(value) k nastavení výchozí úrovně přiblížení (v procentech) pro zobrazení listů.
• Barvy záložek přiřazené pomocí Worksheet::SetTabColor pomáhají uživatelům vizuálně rozlišovat listy.

Běžné problémy

API Reference Shrnutí

Viz také:

• Aspose.Cells for C++ — Enterprise Documentation