Klasse TXLSPaginationModel
TXLSPaginationModel erstellt eine ausgabeunabhängige Folge logischer Seiten für klassische XLS- und moderne XLSX-Bereiche, Arbeitsblätter oder Arbeitsmappen
Jede Seite trägt Papiergeometrie, Ränder, Skalierung, Zeilen- und Spaltenbänder, wiederholte Drucktitel, Kopfzeilen, Fußzeilen, Gitternetzlinien-Richtlinie, Seitenreihenfolge und Zeichnungsplatzierungen
Build-Methoden
function Build(Range: IXLSRange): Boolean; overload; function Build(Worksheet: TXLSWorksheet): Boolean; overload; function Build(Workbook: TXLSWorkbook): Boolean; overload; function Build(Range: TXLSXRange): Boolean; overload; function Build(Worksheet: TXLSXWorksheet): Boolean; overload; function Build(Workbook: TXLSXWorkbook): Boolean; overload;
Jeder Build-Aufruf löscht das vorherige Ergebnis, schließt ausgeblendete Arbeitsmappenblätter aus und wendet den Druckbereich des Arbeitsblatts an, wenn UseWorksheetPageSetup aktiviert ist
Elemente logischer Seiten
| DocumentPageNumber | 1-basierte Seitenzahl über die gesamte Arbeitsmappe |
| SheetPageNumber | 1-basierte Seitenzahl innerhalb des zugehörigen Arbeitsblatts |
| PageWidth / PageHeight | Papierabmessungen in Punkten nach Anwendung der Ausrichtung |
| Margins | Linke, rechte, obere, untere, Kopf- und Fußzeilenränder in Punkten |
| Scale | Aufgelöster Arbeitsblatt-Zoom oder Skalierung für Anpassen an Seite von 0,1 bis 4 |
| Rows / RowEdges | Tatsächliche Arbeitsblattzeilen und ihre Seitenkoordinaten von oben nach unten |
| Columns / ColumnEdges | Tatsächliche Arbeitsblattspalten und ihre Seitenkoordinaten von links nach rechts |
| Drawings | Seitenbeschnittene Platzierungen für Bilder, Diagramme, Textfelder, Formen und Steuerelemente |
| PrintComments | Kommentar-Rendermodus für paginierte Ausgabe; xpcAtEnd hängt unter der letzten Datenzeile der letzten Blattseite eine Kommentarliste an (Zelladresse, Autor und Text), während xpcNone Kommentare weglässt |
Wiedergabe und Metadateien
RenderPage zeichnet eine Seite in einen beliebigen VCL-TCanvas und skaliert die Seite proportional in vom Aufrufer bereitgestellte Grenzen
RenderPageToBackend zeichnet eine Seite in ein TXLSGraphicsBackend, und RenderXlsxCellsToBackend malt die style-bewusste XLSX-Zellebene (feste Füllungen, reduzierte Rahmen, Schrift/Farbe/Ausrichtung pro Zelle, Shrink-to-fit und Textüberlauf in leere Nachbarn) für eine logische Seite
CreatePageMetafile gibt eine verwaltete TMetafile zurück, während SavePageAsMetafile eine Seite direkt in eine EMF-Datei schreibt
TXLSPDFExport.CreatePaginationModel gibt dasselbe Modell zurück, das mit den Ausrichtungs-, Rand- und Zeilenhöhen-Standardwerten des Exporters konfiguriert ist; der Aufrufer verwaltet das zurückgegebene Modell
Beispiel
Pages := TXLSPaginationModel.Create;
try
if Pages.Build(Workbook) then
Pages.SavePageAsMetafile(0, 'FirstPage.emf');
finally
Pages.Free;
end;