Functie voor werkmapviewer

Overzicht

Naast bestandsmanipulatie moeten Delphi-bureaubladtoepassingen werkmappen vaak visueel aan gebruikers tonen; HotXLS bevat een visueel besturingselement om werkbladen rechtstreeks binnen VCL- en FMX-formulieren weer te geven

Besturingselement TXLSWorkbookViewer

De component TXLSWorkbookViewer biedt scrollen, rechthoekige selectie, bewerken, formule-invoer, opmerkingen, hyperlinks, voorwaardelijke opmaak en afdrukvoorbeeld, zonder tijdelijke bestanden aan te maken

Wijs Workbook toe voor klassieke XLS-werkmappen of XlsxWorkbook voor XLSX- en ODS-werkmappen, of roep LoadFromFile aan zodat het besturingselement zelf eigenaar van de geladen werkmap wordt

Bewerken en formule-invoer

Zet Editable op True om bewerken via F2, dubbelklik, afdrukbare toetsen, Delete en de formulebalk mogelijk te maken; vergrendelde cellen op een beveiligd werkblad blijven alleen-lezen, terwijl expliciet ontgrendelde cellen bewerkbaar blijven

FormulaBarText geeft de formule van de geselecteerde cel terug met voorloop-isoteken, of de invoerwaarde; bij toewijzing wordt een nieuwe formule of getypte waarde toegepast en worden afhankelijke formules herberekend

Undo en Redo gebruiken een begrensde circulaire geschiedenis die via UndoLimit wordt gestuurd; het ongedaan maken van een net aangemaakte XLSX-cel herstelt de afwezige sparse-storage-toestand. Elk geschiedenisitem is een TXLSViewerCellState-momentopname (soort werkmap, bestaan, werkblad, coördinaten, formule, waarde en opmaakstatus), ook beschikbaar via de publieke methode om de celstatus te lezen

De bewerkingshooks zijn getypeerde callbacks: OnBeforeEdit (een TXLSViewerBeforeEditEvent) ontvangt de voorgestelde tekst en kan die weigeren of herschrijven via Allow en Text, en OnAfterEdit (een TXLSViewerAfterEditEvent) rapporteert de vastgelegde tekst

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

Bereik- en referentieselectie

Gebruik Shift-navigatie, slepen met de muis of SelectRange om een rechthoekige selectie te maken die beschikbaar is via SelectionTop, SelectionLeft, SelectionBottom, SelectionRight en SelectedRange

BeginReferencePick schakelt de formuleverwijzingsmodus in, en OnReferencePick (een TXLSViewerReferenceEvent) publiceert het huidige A1-bereik zodra de selectie verandert; roep EndReferencePick aan zodra de formulebalk van de host de verwijzing heeft geaccepteerd

Weergave-eigenschappen

Raadpleeg de configuratiebesturingselementen hieronder

• Referentiehandleiding voor WorkbookViewer-component — Besturingselementen voor lay-outeigenschappen
• Eigenschap DisplayGridLines — Gridranden in-/uitschakelen
• Eigenschap Zoom — Zoomverhoudingen van werkblad instellen