HotXLS-dokumentation

Funktion för arbetsboksvisare

Översikt

Förutom filhantering behöver Delphi-skrivbordsprogram ofta visa och redigera arbetsböcker; HotXLS innehåller en visuell VCL-komponent som renderar någon av arbetsboksmodellerna direkt

Kontrollen TXLSWorkbookViewer

Komponenten TXLSWorkbookViewer tillhandahåller rullning, rektangulär markering, redigering, formelinmatning, kommentarer, hyperlänkar, villkorsstyrd formatering och förhandsgranskning av utskrift utan att skapa temporära filer

Tilldela Workbook för klassisk XLS eller XlsxWorkbook för XLSX- och ODS-arbetsböcker, eller anropa LoadFromFile för att låta kontrollen äga den inlästa arbetsboken

Redigering och formelinmatning

Sätt Editable till True för att aktivera redigering via F2, dubbelklick, utskrivbara tangenter, Delete och formelfältet; skyddade låsta celler förblir skrivskyddade medan uttryckligt olåsta celler förblir redigerbara

FormulaBarText returnerar den markerade cellens formel med inledande likhetstecken eller dess inmatningsvärde, och tilldelning av egenskapen tillämpar en ny formel eller ett inskrivet värde samt räknar om beroende formler

Undo och Redo använder en avgränsad cirkulär historik styrd av UndoLimit; att ångra en nyskapad XLSX-cell återställer dess frånvarande tillstånd i gleslagringen. Varje historikpost är en TXLSViewerCellState-ögonblicksbild (arbetsbokstyp, existens, blad, koordinater, formel, värde och formatläge), som också är tillgänglig via den publika metoden för att läsa tillstånd

Redigeringskrokarna är typade callbacks: OnBeforeEdit (en TXLSViewerBeforeEditEvent) tar emot den föreslagna texten och kan lägga veto eller skriva om den via Allow och Text, och OnAfterEdit (en TXLSViewerAfterEditEvent) rapporterar den genomförda texten

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

Val av område och referens

Använd Shift-navigering, musdragning eller SelectRange för att skapa en rektangulär markering som exponeras via SelectionTop, SelectionLeft, SelectionBottom, SelectionRight och SelectedRange

BeginReferencePick aktiverar läget för formelreferenser och OnReferencePick (en TXLSViewerReferenceEvent) publicerar det aktuella A1-området varje gång markeringen ändras; anropa EndReferencePick när värdformeleditorn har godtagit referensen

Visningsegenskaper

Se konfigurationskontrollerna nedan