Funcionalidade de visualização de livro

Visão geral

Para além da manipulação de ficheiros, as aplicações desktop Delphi frequentemente precisam de apresentar livros visualmente aos utilizadores; o HotXLS inclui um controlo visual para renderizar folhas de cálculo diretamente dentro de formulários VCL e FMX

Controlo TXLSWorkbookViewer

O componente TXLSWorkbookViewer proporciona deslocamento, seleção retangular, edição, introdução de fórmulas, comentários, hiperligações, formatação condicional e pré-visualização de impressão, sem criar ficheiros temporários

Atribua Workbook para livros Classic XLS ou XlsxWorkbook para livros XLSX e ODS, ou chame LoadFromFile para que o controlo fique proprietário do livro carregado

Edição e introdução de fórmulas

Defina Editable como True para ativar a edição com F2, duplo clique, teclas imprimíveis, Delete e barra de fórmulas; as células bloqueadas de folhas protegidas mantêm-se só de leitura, enquanto as células explicitamente desbloqueadas permanecem editáveis

FormulaBarText devolve a fórmula da célula selecionada com o sinal de igualdade inicial ou o seu valor de entrada, e atribuir a propriedade aplica uma nova fórmula ou valor introduzido 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 repõe o seu estado de ausência do armazenamento esparso. Cada entrada do histórico é um instantâneo TXLSViewerCellState (tipo de livro, existência, folha, coordenadas, fórmula, valor e estado de formato), também disponível através do método público de leitura de estado

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

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

Seleção de intervalos e referências

Use a navegação com Shift, o arrastamento com o rato ou SelectRange para criar uma seleção retangular exposta através de SelectionTop, SelectionLeft, SelectionBottom, SelectionRight e SelectedRange

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

Propriedades de apresentação

Verifique os controlos de configuração abaixo

• Guia de referência do componente WorkbookViewer — Controlos das propriedades de esquema
• Propriedade DisplayGridLines — Alternar os limites da grelha
• Propriedade Zoom — Definir as proporções de zoom da folha