HotXLS 文件
首頁目錄進階工作流程

TXLSPaginationModel 類別

TXLSPaginationModel 為傳統 XLS 與現代 XLSX 範圍、工作表或活頁簿建立與輸出無關的邏輯頁面序列

每個頁面承載紙張幾何、邊界、縮放、資料列與資料行帶、重複列印標題、頁首、頁尾、格線原則、頁面順序與圖案位置

建立方法

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;

每次 Build 呼叫都會清除先前的結果、排除隱藏的活頁簿工作表，並在啟用 UseWorksheetPageSetup 時套用工作表列印區域

邏輯頁面成員

DocumentPageNumber跨完整活頁簿的以一為基底頁碼
SheetPageNumber所屬工作表內的以一為基底頁碼
PageWidth / PageHeight套用方向後以點為單位的紙張尺寸
Margins以點為單位的左、右、上、下、頁首與頁尾邊界
Scale已解析的工作表縮放或從 0.1 到 4 的符合頁面縮放
Rows / RowEdges實際工作表資料列及其由上而下的頁面座標
Columns / ColumnEdges實際工作表資料行及其由左而右的頁面座標
Drawings頁面裁剪的影像、圖表、文字方塊、圖案與控制項位置
PrintComments分頁輸出的備註呈現模式； xpcAtEnd 會在工作表最後一頁的最後一個資料列下方附加一份備註清單（儲存格位址、作者與內容）， xpcNone 則省略備註

轉譯與中繼檔

RenderPage 將一個頁面繪製到任何 VCL TCanvas ，並將頁面等比縮放至呼叫端提供的界限內

RenderPageToBackend 傳回所擁有的 TXLSGraphicsBackend， RenderXlsxCellsToBackend 則將一個頁面直接寫入 EMF 檔案

CreatePageMetafile 傳回所擁有的 TMetafile，而 SavePageAsMetafile 則將一個頁面直接寫入 EMF 檔案

TXLSPDFExport.CreatePaginationModel 傳回以匯出器的方向、邊界與資料列高度預設值設定的相同模型，且呼叫端擁有傳回的模型

範例

Pages := TXLSPaginationModel.Create;
try
  if Pages.Build(Workbook) then
    Pages.SavePageAsMetafile(0, 'FirstPage.emf');
finally
  Pages.Free;
end;

另請參閱