Respostas práticas para as dúvidas iniciais dos usuários do HotXLS

Quais versões do Delphi e C++Builder são suportadas?

O pacote completo atende Delphi e C++Builder do XE5 até o RAD Studio 13.1 Florence; o instalador da versão trial fornece atualmente pacotes para RAD Studio 11.3, 12.3 e 13.1

Por que o instalador lista apenas algumas versões do IDE?

A página do IDE lista as instalações suportadas do RAD Studio detectadas na máquina atual; se um IDE suportado não estiver listado, confirme se o RAD Studio está instalado e se o instalador está sendo executado no mesmo perfil de usuário do Windows que possui as configurações do IDE

Onde aparecem os componentes em tempo de design?

O instalador registra uma guia na Tool Palette chamada losLab; os componentes visuais são DataToXLS e GridToXLS

Por que os pacotes ou demos do C++Builder estão ausentes após a instalação?

Os arquivos de pacote e projetos de demonstração do C++Builder são conteúdos opcionais do instalador; marque a caixa de seleção do IDE C++Builder correspondente durante a configuração se precisar de integração ou demonstrações do C++Builder

Win32 e Win64 são suportados?

Sim, o HotXLS fornece saídas de pacote padrão Win32 e Win64 para as versões suportadas do IDE; o instalador pode registrar caminhos de biblioteca Win64x para reconstruções de código-fonte, mas pacotes Win64x pré-compilados não são fornecidos no momento

Preciso ter o Microsoft Excel instalado?

Não, o HotXLS lê, grava, estiliza e exporta pastas de trabalho diretamente; não requer Microsoft Excel, automação do Office, automação COM ou um processo de planilha externo

Quais limites a versão trial aplica?

Por pasta de trabalho, a versão trial permite até 5 planilhas, 100 linhas por planilha e 26 colunas por planilha; os mesmos limites se aplicam à interface XLS e à interface XLSX

Por que minha saída da versão trial para após a coluna Z ou a linha 100?

Gravações além dos limites da versão trial são aceitas pela API, mas descartadas do arquivo salvo; a versão completa remove esses limites sem exigir alterações no código-fonte

A versão trial truncará os arquivos que eu abrir?

Não, abrir uma pasta de trabalho existente com mais de 5 planilhas ou mais de 100 linhas e 26 colunas não trunca o arquivo; os limites se aplicam às adições de planilhas iniciadas pelo usuário e às gravações de células após a criação da pasta de trabalho

A versão trial mostra avisos quando um limite é atingido?

Não, os limites são silenciosos: nenhuma caixa de diálogo, linha de log ou exceção é emitida quando uma gravação excede o limite da versão trial

Devo usar lxHandle ou lxHandleX?

Use lxHandle para fluxos de trabalho clássicos em XLS do Excel 97-2003 e código de relatório legado; use lxHandleX e TXLSXWorkbook para arquivos XLSX do Excel 2007+ e recursos específicos de OOXML

Um projeto pode usar as duas interfaces?

Sim, os aplicativos podem incluir ambas as unidades e manter objetos de pasta de trabalho separados para cada formato de arquivo; isso é útil ao manter a saída XLS antiga enquanto se adicionam novos relatórios XLSX

Por que alguns recursos do XLSX não estão disponíveis na API XLS antiga?

XLS e XLSX têm modelos de arquivo diferentes; conceitos exclusivos do XLSX, como strings compartilhadas, estilos OOXML, tabelas, planilhas de gráfico e relacionamentos de pacotes, existem em lxHandleX em vez de serem adaptados para a interface XLS clássica

Por onde devo começar com o código de exemplo?

Comece com as demonstrações QuickStart e ApiTour nas pastas de demonstração do Delphi ou C++Builder; para código específico do XLSX, use a visão geral da interface XLSX e as demonstrações de exportação de XLSX

Quais recursos do XLSX são suportados?

TXLSXWorkbook suporta valores, fórmulas, cálculo explícito de fórmulas, estilos, formatos numéricos personalizados, larguras e alturas, células mescladas, exportação em HTML em nível de intervalo, hiperlinks, comentários, imagens, formatação condicional, validação de dados, filtros, tabelas, gráficos, rich text, propriedades do documento, visibilidade da planilha, configuração da página, salvamento criptografado com AES e abertura/salvamento baseados em fluxo

Posso salvar ou abrir arquivos XLSX a partir de fluxos?

Sim, a interface XLSX suporta SaveAs(Stream) e Open(Stream), que são adequados para buffers de memória, campos BLOB de banco de dados, respostas HTTP e outros caminhos de armazenamento que não sejam arquivos

Como grandes exportações em XLSX devem ser tratadas?

Use a interface XLSX e ative Workbook.StreamingWrite quando o relatório for gerado planilha por planilha; as gravações em fluxo reduzem a pressão na memória da pasta de trabalho durante o salvamento

O HotXLS pode abrir ou salvar arquivos XLSX criptografados com senha?

TXLSXWorkbook.SaveAsEncrypted pode gravar um contêiner XLSX protegido por AES do ECMA-376 quando você fornece uma senha não vazia; OpenEncrypted pode recorrer ao Open comum para pacotes não criptografados, mas ainda gera EXlsxEncryptionNotImplemented para pacotes criptografados até que o suporte a descriptografia seja lançado; a proteção de planilha e de pasta de trabalho continuam sendo recursos de bloqueio separados no estilo do Excel

Posso preservar macros?

A interface XLSX pode manter uma carga útil vbaProject.bin byte por byte através da pasta de trabalho e expor uma visualização somente leitura analisada ParsedVBAProject para armazenamento VBA válido; não compila nem executa código VBA

As fórmulas são calculadas dentro do HotXLS?

O HotXLS grava o texto da fórmula nas pastas de trabalho salvas, e os aplicativos de planilha podem recalcular essas células quando o arquivo é aberto; para avaliação explícita em processo, tanto as interfaces XLS clássica quanto XLSX expõem Calculate; atribua OnUserFunction quando funções de planilha personalizadas ou não suportadas precisarem ser tratadas pelo código do aplicativo

O HotXLS pode exportar para outros formatos além do XLS ou XLSX?

Sim, o HotXLS inclui auxiliares de exportação para formatos como CSV, TSV, HTML e RTF; use a interface que corresponde ao formato da sua pasta de trabalho e escolha o método de exportação necessário para o seu fluxo de trabalho

Posso usar o HotXLS em serviços ou ferramentas em lote?

Sim, como o HotXLS não automatiza o Excel, ele é adequado para aplicativos de desktop, serviços, tarefas em lote, instaladores e utilitários no lado do servidor em que a automação do Office seria frágil ou indisponível

Existem taxas de royalties em tempo de execução?

Não, o HotXLS não exige taxas de royalties em tempo de execução; você precisa de licenças de desenvolvedor para os desenvolvedores que criam aplicativos com a biblioteca

Onde devo procurar antes de pedir ajuda?

• Visão geral do produto para o escopo de recursos e layout do pacote
• Documentação em HTML para as páginas de referência da API
• Visão geral da interface XLSX para exemplos modernos de pastas de trabalho
• Aviso sobre os limites da versão trial quando a saída da versão trial for menor que o esperado