Trabajar con la gestión de Spreadsheet

El Workbook clase es el punto de entrada para todas las operaciones de la hoja de trabajo en Aspose.Cells FOSS para C++. proporciona métodos para crear nuevos libros de obra, cargar archivos XLSX existentes, gestionar los paneles de laboratorio y salvar el resultado.

Crear un nuevo libro de trabajo

Instantía Workbook para crear un libro de trabajo vacío. se crea automáticamente una hoja de obra por defecto.

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

Cargar un libro de trabajo existente

Pasar un archivo a la Workbook Constructor para cargar un archivo XLSX existente.Después de cargarse, las hojas de trabajo y los datos celulares son accesibles inmediatamente.

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

Configuración de propiedades de la hoja de trabajo

El Worksheet clase exponen las propiedades de pantalla y protección. Utilice estas para configurar la visibilidad de hoja, la pantalla de red, el zoom y el color de la tabla.

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

Proteger y no proteger una hoja de trabajo

llamadas Worksheet::Protect para cerrar una hoja contra los editos, y Worksheet::Unprotect Para eliminar la protección:

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

- Garantizar un único cuadro y el alcance definido de nombre

Al añadir múltiples hojas de trabajo programáticamente, utiliza Workbook::EnsureUniqueSheetName para evitar colisiones de nombre.Utilizar Workbook::EnsureValidDefinedNameScope para que se valide que los nombres definidos son desvelados correctamente.

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

Salvar un libro de trabajo

llamadas Workbook::Save(fileName) para escribir el libro de trabajo en disco.Múltiples sobrecargas aceptan un nombre de archivo, una corriente o un explicit SaveFormat.

workbook.Save("products.xlsx");

Consejos y mejores prácticas

Siempre llamo Workbook::Dispose() Cuando se hace con un libro de trabajo para liberar recursos no gestionados.
Los nombres de la hoja de trabajo deben ser únicos dentro de un libro de trabajos - uso EnsureUniqueSheetName Después de las adiciones.
Sitio Worksheet::SetShowGridlines(false) para las hojas de estilo de presentación para mejorar la lectura.
Uso Worksheet::SetZoom(value) para establecer un nivel de zoom (percentaje) por defecto para las vistas de la hoja de trabajo.
Colores de la tab atribuidas a través del Worksheet::SetTabColor Ayuda a los usuarios a distinguir las hojas de trabajo visualmente.

Problemas comunes

Problemas	Causas	Fixado
Archivo no encontrado en carga	El camino incorrecto	Utilice un camino absoluto o verifique el directorio de trabajo
Nombre de la colisión	Duplicar nombres al añadir hojas	llamadas `EnsureUniqueSheetName()` Después de cada adición
Los cambios del libro no se salvaron	`Save` No llamado	Siempre llamo `workbook.Save(path)` Antes de salir
Memoria de alerta	`Dispose` No llamado	llamadas `workbook.Dispose()` Al final del alcance

Sumación de referencia API

Clase / Método	Descripción
`Workbook()`	Crea un nuevo libro de trabajo vacío
`Workbook(filePath)`	Carga un archivo XLSX existente
`Workbook::Save(fileName)`	Salva el libro de trabajo en disco
`Workbook::EnsureUniqueSheetName()`	Resuelve los nombres de las hojas duplicadas
`Workbook::Dispose()`	Liberación de recursos
`Worksheet::SetName(name)`	Renovación de la hoja de trabajo
`Worksheet::SetShowGridlines(bool)`	Visibilidad de la línea de red Toggles
`Worksheet::SetZoom(percent)`	- Procentaje de zoom
`Worksheet::Protect(password)`	Lancre el taller
`Worksheet::Unprotect(password)`	Desbloquear la hoja de trabajo

Trabajar con la gestión de Spreadsheet