Advanced Workbook Workflows

Den här guiden samlar de API:er på högre nivå som är mest användbara när ett arbetsboksflöde går utöver grundläggande läsning och skrivning av celler

Print-ready PDF output

PDF-exporter för klassiska XLS- och moderna XLSX-arbetsböcker, kalkylblad och områden renderar formaterade värden, cellfyllnader, typsnittsfärg och betoning, justering, kantlinjer, valfritt rutnät, kolumnbredder, radhöjder, manuella sidbrytningar, upprepade utskriftstitlar och tredelade sidhuvuden och sidfötter

Sheet.PageSetup.PrintArea := 'A1:H80';
Sheet.PageSetup.PrintTitleRows := '$1:$3';
Sheet.PageSetup.RightHeader := 'Page &P of &N';
Sheet.HPageBreaks.Add(45);
Workbook.SaveAsPDF('report.pdf');

Modern workbooks expose the same direct entry points through TXLSXWorkbook, TXLSXWorksheet, and TXLSXRange

ModernSheet.PrintArea := '$A$1:$H$80';
ModernSheet.PrintTitleRows := '$1:$3';
ModernSheet.AddRowBreak(45);
ModernWorkbook.SaveAsPDF('modern-report.pdf');

Text utanför WinAnsi skrivs med ett inbäddat TrueType CID-typsnitt och en ToUnicode-mappning så att läsare kan rendera och extrahera Unicode-text

Set TXLSPDFExport.UnicodeFontFile när en arbetsbok behöver ett visst skriftsystem eller ett företagstypsnitt, i annat fall väljer exportören ett lämpligt installerat typsnitt om det finns

Use TXLSPaginationModel när förhandsgranskning, PDF och anpassad utdata måste dela samma pappersgeometri, marginaler, anpassningsskala, manuella brytningar, upprepade rubriker, sidordning, sidhuvuden, sidfötter och ritförankringar

Pages := Exporter.CreatePaginationModel(Workbook);
try
  Pages.SavePageAsMetafile(0, 'FirstPage.emf');
finally
  Pages.Free;
end;

Progress, cancellation, and diagnostics

Use OnProgressEx för begin-, work- och end-callbacks och sätt dess abort-argument för att avbryta en operation

Inspect Diagnostics or LastDiagnostic efter misslyckad sparning, öppning eller omberäkning i stället för att bara förlita sig på ett numeriskt returvärde

Unsupported OOXML package parts

TXLSXWorkbook.PreserveUnsupportedParts har true som standard och behåller egna delar som kan nås via okända rot-, arbetsboks-, kalkylblads- eller ritningsrelationer

UnsupportedPartCount and UnsupportedPartBytes report retained content, while ClearUnsupportedParts intentionally removes it before a save

Rich clipboard exchange

Call range-level CopyToClipboard för att publicera både Unicode-tabelltext och CF_HTML, inklusive visningsformatering, formler, sammanslagna celler, länkar och säkert citerade inbäddade avgränsare

VBA source editing

After loading a VBA project, update an existing module's SourceCode and save the workbook or standalone storage

Skrivmotorn komprimerar om bara den redigerade källströmmen och bevarar strömprefix och orört projektinnehåll

Classic form controls

MacroName := Workbook.Names.Add('RunReport', '=0', False);
MacroName.IsMacro := True;
Button := Sheet.AddButton('Run report', 1, 2, 2, 5);
Button.MacroName := 'RunReport';
CheckBox := Sheet.AddCheckBox('Approved', 2, 2, 3, 5);
CheckBox.State := xcsMixed;
CheckBox.LinkedCell := 'Controls!$F$2';
RadioButton := Sheet.AddRadioButton('Primary', 4, 2, 5, 5);
RadioButton.FirstInGroup := True;
ComboBox := Sheet.AddComboBox(5, 2, 6, 5);
ComboBox.SourceRange := 'Controls!$A$1:$A$8';
ListBox := Sheet.AddListBox(8, 2, 12, 5);
ListBox.SourceRange := 'Controls!$A$1:$A$8';

The returned typed wrappers expose labels, control kinds, anchors, enumeration, and deletion

Selective format patches

Target.ApplyFormatPatch(Source, [xfpFont, xfpFill, xfpNumberFormat]);

Ett mindre källområde läggs sida vid sida över ett större mål, och omarkerad formatering plus alla målvärden lämnas oförändrade

Master-detail dataset export

Enable TDataToXLS.ReadDetailTables to export linked detail datasets below every master record and enable IndentDetailTables to add one column of indentation per relationship level

WordArt

Shape := Sheet.AddWordArt('HotXLS', 'textArchUp', 2, 2, 6, 8);
Shape.TextColor := $FF00A060;
Shape.OutlineColor := $FF17365D;

Det kompletta DrawingML-ankaret överlever senare öppnings- och sparningscykler via bevarandevägen för rå ritning

See Demo\Delphi\FeatureShowcase för ett kompakt körbart exempel som kombinerar PDF-utskrift, formulärkontroller, formatkorrigeringar och WordArt