Treballar amb la gestió de fitxes de càlcul

El Workbook class és el punt d’entrada per a totes les operacions de la tàula en Aspose.Cells FOSS for C++. Ofereix mètodes per crear nous quadres, carregar arxius XLSX existents, gestionar fitxes i guardar el resultat.

Creació d’un nou llibre de treball

Instantiate Workbook Crear una carpeta de treball buida. Una fitxa de feina predeterminada es crea automàticament.

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

Carregar un llibre de treball existent

Passar una ruta de fitxer a la pàgina d’accés. Workbook Constructor per carregar un arxiu XLSX existent. Després de la càrrega, les fulles de treball i dades de cèl·lules són accessibles immediatament.

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

Configuració de les propietats del full d’obra

El Worksheet classe exposa propietats d’exposició i protecció. Utilitza-les per configurar la visibilitat de les fitxes, l’exhibició en xarxa, el zoom i el color de la pesta.

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

Protecció i desprotecció d’un full de treball

Call Worksheet::Protect bloquejar una pàgina contra edicions, i Worksheet::Unprotect per eliminar la protecció:

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

Garantir una fulla única i un àmbit de nom definit

Quan s’afegeixen múltiples fulles de treball programàticament, utilitzar Workbook::EnsureUniqueSheetName per evitar col·lisions de noms. Workbook::EnsureValidDefinedNameScope validar que els noms definits tenen un abast correcte.

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

Salvar un llibre de treball

Call Workbook::Save(fileName) Per escriure el llibre de treball al disc. Les sobrecargues múltiples accepten un nom de fitxer, una corrent o una expressa SaveFormat.

workbook.Save("products.xlsx");

Consells i millors pràctiques

Sempre trucar. Workbook::Dispose() quan es fa amb un llibre de treball per alliberar recursos no gestionats.
Els noms de les fitxes han d’estar únics dins un llibre utilitzat. EnsureUniqueSheetName després de les addicions dels lots.
Set de punts Worksheet::SetShowGridlines(false) per a les fitxes de presentació, per millorar la seva legibilitat.
Utilització: Worksheet::SetZoom(value) per definir un nivell de zoom predeterminat (percent) en les vistes a la fitxa.
Colors de pesta assignades a través del Worksheet::SetTabColor ajudar als usuaris a distingir visualment les fulles de treball.

Problemàtiques comuns

Issue	Cause	Correcció
No es va trobar cap fitxer en càrrega.	Tràtxa incorrecta	Utilitzar la ruta absoluta o verificar el directori de treball
Col·lisió de noms de fulla	Noms duplicats en afegir fitxes	Call `EnsureUniqueSheetName()` després de cada addició
No s’han guardat els canvis al llibre de treball	`Save` no cridat.	Sempre trucar. `workbook.Save(path)` abans de sortir.
Advertences de fuga de memòria	`Dispose` no cridat.	Call `workbook.Dispose()` al final de l’àmbit d’aplicació

Resum de referència d’API

Classe/mètode	Description
`Workbook()`	Crea un nou llibre de treball buit.
`Workbook(filePath)`	Carrega un arxiu XLSX existent
`Workbook::Save(fileName)`	Salva el llibre a disc
`Workbook::EnsureUniqueSheetName()`	Resolver noms de fletes duplicats
`Workbook::Dispose()`	Libera recursos
`Worksheet::SetName(name)`	Renomenar la fitxa de treball
`Worksheet::SetShowGridlines(bool)`	Intercanvia la visibilitat de les línies de xarxa
`Worksheet::SetZoom(percent)`	Ajusta el percentatge de zoom predeterminat
`Worksheet::Protect(password)`	Bloqueja la fulla de treball
`Worksheet::Unprotect(password)`	Obre la fulla de treball

Treballar amb la gestió de fitxes de càlcul