Documentação HotXLS

Recurso de visualização de pasta de trabalho

Visão geral

Além da manipulação de arquivos, os aplicativos desktop Delphi frequentemente precisam exibir pastas de trabalho visualmente aos usuários; o HotXLS inclui um controle visual para renderizar planilhas diretamente dentro de formulários VCL e FMX

Controle TXLSWorkbookViewer

O componente TXLSWorkbookViewer oferece rolagem, seleção retangular, edição, entrada de fórmulas, comentários, hyperlinks, formatação condicional e print preview sem criar arquivos temporários

Atribua Workbook para pastas de trabalho XLS clássicas ou XlsxWorkbook para pastas de trabalho XLSX e ODS, ou chame LoadFromFile para deixar o controle como proprietário da pasta de trabalho carregada

Edição e entrada de fórmulas

Defina Editable como True para habilitar edição via F2, duplo clique, teclas imprimíveis, Delete e barra de fórmulas; células bloqueadas por proteção permanecem somente leitura, enquanto células explicitamente desbloqueadas continuam editáveis

FormulaBarText retorna a fórmula da célula selecionada com o sinal de igual inicial ou seu valor de entrada, e atribuir a propriedade aplica uma nova fórmula ou valor digitado e recalcula as fórmulas dependentes

Undo e Redo usam um histórico circular limitado controlado por UndoLimit; desfazer uma célula XLSX recém-criada restaura seu estado ausente de armazenamento esparso. Cada entrada do histórico é um snapshot TXLSViewerCellState (tipo de pasta de trabalho, existência, planilha, coordenadas, fórmula, valor e estado de formato), também disponível pelo método público de leitura de estado

Os hooks de edição são callbacks tipados: OnBeforeEdit (um TXLSViewerBeforeEditEvent) recebe o texto proposto e pode vetá-lo ou reescrevê-lo por meio de Allow e Text, e OnAfterEdit (um TXLSViewerAfterEditEvent) informa o texto confirmado

Viewer.Editable := True;
Viewer.GoToCell(2, 3);
Viewer.FormulaBarText := '=A1*2';
Viewer.Undo;
Viewer.Redo;

Seleção de intervalo e referência

Use navegação com Shift, arrastar com o mouse ou SelectRange para criar uma seleção retangular exposta por meio de SelectionTop, SelectionLeft, SelectionBottom, SelectionRight e SelectedRange

BeginReferencePick habilita o modo de referência de fórmula e OnReferencePick (um TXLSViewerReferenceEvent) publica o intervalo A1 atual sempre que a seleção muda; chame EndReferencePick quando o editor de fórmulas host tiver aceitado a referência

Propriedades de exibição

Verifique os controles de configuração abaixo

Copyright © 2010-2026 losLab Software