Projektmappe-fremviserfunktion

Oversigt

Ud over filhåndtering skal Delphi-desktopprogrammer ofte også vise og redigere projektmapper; HotXLS indeholder et visuelt VCL-kontrolelement, der renderer begge projektmappe-modeller direkte

Kontrolelementet TXLSWorkbookViewer

Komponenten TXLSWorkbookViewer leverer rulning, rektangulær markering, redigering, formelinput, kommentarer, hyperlinks, betinget formatering og udskriftsvisning uden at oprette midlertidige filer

Tildel Workbook til klassisk XLS eller XlsxWorkbook til XLSX- og ODS-projektmapper, eller kald LoadFromFile, så kontrolelementet får ejerskab af den indlæste projektmappe

Redigering og formelinput

Sæt Editable til True for at aktivere redigering via F2, dobbeltklik, almindelige taster, Delete og formellinjen; beskyttede låste celler forbliver skrivebeskyttede, mens eksplicit oplåste celler forbliver redigerbare

FormulaBarText returnerer den valgte celles formel med indledende lighedstegn eller dens inputværdi, og tildeling af egenskaben anbringer en ny formel eller en indtastet værdi og genberegner afhængige formler

Undo og Redo bruger en afgrænset cirkulær historik styret af UndoLimit; fortruddes en nycoprettet XLSX-celle, gendannes dens fraværende sparse-lagringstilstand. Hvert historikpunkt er et TXLSViewerCellState-snapshot (projektmappe-type, eksistens, ark, koordinater, formel, værdi og formattilstand), som også er tilgængeligt via den offentlige metode til aflæsning af tilstanden

Redigerings-hook'erne er typede callbacks: OnBeforeEdit (en TXLSViewerBeforeEditEvent) modtager den foreslåede tekst og kan nægte eller omskrive den via Allow og Text, og OnAfterEdit (en TXLSViewerAfterEditEvent) rapporterer den gemte tekst

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

Område- og referencevalg

Brug Shift-navigation, musetræk eller SelectRange til at lave en rektangulær markering, som eksponeres via SelectionTop, SelectionLeft, SelectionBottom, SelectionRight og SelectedRange

BeginReferencePick aktiverer formelreferencetilstand, og OnReferencePick (en TXLSViewerReferenceEvent) publicerer det aktuelle A1-område, hver gang markeringen ændres; kald EndReferencePick, når værtens formeleditor har accepteret referencen

Visningsegenskaber

Se konfigurationskontrolelementerne nedenfor

• Referencemanual til komponenten WorkbookViewer — Styring af layoutegenskaber
• Egenskaben DisplayGridLines — Slå gitterkanter til/fra
• Egenskaben Zoom — Angiv ark-zoomforhold