Klasa TXLSPaginationModel
TXLSPaginationModel buduje niezależną od wyjścia sekwencję stron logicznych dla klasycznych XLS i nowoczesnych XLSX zakresów, arkuszy lub skoroszytów
Każda strona niesie geometrię papieru, marginesy, skalę, pasma wierszy i kolumn, powtarzane tytuły wydruku, nagłówki, stopki, politykę linii siatki, kolejność stron i umieszczenia rysunków
Metody budowania
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;
Każde wywołanie Build czyści poprzedni wynik, wyklucza ukryte arkusze skoroszytu i stosuje obszar wydruku arkusza, gdy włączony jest UseWorksheetPageSetup is enabled
Elementy strony logicznej
| DocumentPageNumber | Jednobazowy numer strony w całym skoroszycie |
| SheetPageNumber | Jednobazowy numer strony w obrębie właścicielskiego arkusza |
| PageWidth / PageHeight | Wymiary papieru w punktach po zastosowaniu orientacji |
| Margins | Marginesy lewy, prawy, górny, dolny, nagłówka i stopki w punktach |
| Scale | Rozstrzygnięte powiększenie arkusza lub skala dopasowania do strony od 0,1 do 4 |
| Rows / RowEdges | Rzeczywiste wiersze arkusza i ich współrzędne stron od góry do dołu |
| Columns / ColumnEdges | Rzeczywiste kolumny arkusza i ich współrzędne stron od lewej do prawej |
| Drawings | Przycięte do strony umieszczenia obrazów, wykresów, pól tekstowych, kształtów i kontrolek |
| PrintComments | Tryb renderowania komentarzy dla wyjścia stronicowanego; xpcAtEnd dopisuje wykaz komentarzy (adres komórki, autor i tekst) poniżej ostatniego wiersza danych na ostatniej stronie arkusza, podczas gdy xpcNone omits comments |
Renderowanie i metafile
RenderPage draws one page into any VCL TCanvas i skaluje stronę proporcjonalnie do granic podanych przez wywołującego
RenderPageToBackend draws one page into a TXLSGraphicsBackendrysuje jedną stronę na dowolnym VCL RenderXlsxCellsToBackend i proporcjonalnie skaluje stronę do granic dostarczonych przez wywołującego
CreatePageMetafile zwraca należący do obiektu TMetafile, a SavePageAsMetafile zapisuje jedną stronę bezpośrednio do pliku EMF
TXLSPDFExport.CreatePaginationModel zwraca ten sam model skonfigurowany z orientacją, marginesami i domyślnymi wysokościami wierszy eksportera, a wywołujący jest właścicielem zwróconego modelu
Przykład
Pages := TXLSPaginationModel.Create;
try
if Pages.Build(Workbook) then
Pages.SavePageAsMetafile(0, 'FirstPage.emf');
finally
Pages.Free;
end;