Trabalhar com a gestão de planilhas

A Comissão Workbook class é o ponto de entrada para todas as operações da planilha em Aspose.Cells FOSS for C++. Ele fornece métodos para criar novas pastas de trabalho, carregar arquivos XLSX existentes, gerenciar folhas de cálculo e salvar o resultado.

Criar um novo livro de trabalho

Instanciar Workbook para criar uma pasta de trabalho vazia. Uma folha de cálculo padrão é criada automaticamente.

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

Carregamento de um livro existente

Passe um caminho de arquivo para o Workbook Construtor para carregar um arquivo XLSX existente. Após o carregamento, as folhas de trabalho e os dados das células são acessíveis imediatamente.

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

Configurar as propriedades da planilha

A Comissão Worksheet class expõe as propriedades de exibição e proteção. Use-as para configurar a visibilidade da folha, o display de grade, zoom e cor das abas.

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

Proteger e desproteger uma folha de trabalho

Chama-me . Worksheet::Protect para bloquear uma folha contra edições, e Worksheet::Unprotect para retirar a protecção:

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

Garantir folha única e escopo de nome definido

Ao adicionar várias folhas de trabalho programaticamente, use Workbook::EnsureUniqueSheetName Para evitar colisões de nomes. Workbook::EnsureValidDefinedNameScope Para validar que os nomes definidos são de alcance correto.

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

Salvar um livro de trabalho

Chama-me . Workbook::Save(fileName) Para escrever o livro de trabalho no disco. Vários sobrecargas aceitam um nome de arquivo, uma corrente ou um explícito SaveFormat.

workbook.Save("products.xlsx");

Dicas e melhores práticas

Sempre ligue. Workbook::Dispose() quando feito com uma pasta de trabalho para liberar recursos não gerenciados.
Os nomes das folhas de trabalho devem ser únicos dentro do uso num livro de trabalhos. EnsureUniqueSheetName após adições de lotes.
Set (s) Worksheet::SetShowGridlines(false) para as fichas de estilo de apresentação, a fim de melhorar a legibilidade.
Utilização: Worksheet::SetZoom(value) Para definir um nível de zoom padrão (em percentagem) para as vistas da folha de cálculo.
Cores de guia atribuídas via Worksheet::SetTabColor Ajudar os utilizadores a distinguir visualmente as fichas de trabalho.

Problemas comuns

Emissão	Causa da morte	Correção
Arquivo não encontrado no carregamento	Trilha incorreta .	Use o caminho absoluto ou verifique diretório de trabalho
Coligação de nomes das folhas	Nome duplicado ao adicionar folhas	Chama-me . `EnsureUniqueSheetName()` após cada adição
Mudanças de bloco de trabalho não salvas	`Save` não chamado.	Sempre ligue. `workbook.Save(path)` antes da saída.
Aviso de fuga de memória	`Dispose` não chamado.	Chama-me . `workbook.Dispose()` no final do âmbito de aplicação

Resumo de referência da API

Classe/Método	Descrição:
`Workbook()`	Cria uma nova pasta de trabalho vazia .
`Workbook(filePath)`	Carregar um arquivo XLSX existente
`Workbook::Save(fileName)`	Salva o livro de trabalho no disco .
`Workbook::EnsureUniqueSheetName()`	Resolve nomes de folhas duplicados
`Workbook::Dispose()`	Liberação de recursos
`Worksheet::SetName(name)`	Renomear a folha de cálculo
`Worksheet::SetShowGridlines(bool)`	Intercâmbio da visibilidade de linha de rede
`Worksheet::SetZoom(percent)`	Indicar porcentagem de zoom padrão
`Worksheet::Protect(password)`	Bloqueia a planilha
`Worksheet::Unprotect(password)`	Desbloqueia a planilha de trabalho

Trabalhar com a gestão de planilhas