HotXLS Docs
HomeContentsAdvanced workflows

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;

Every Build 调用会清除上一次结果，排除工作簿中的隐藏工作表，并在 时应用工作表打印区域 UseWorksheetPageSetup is enabled

逻辑页成员

DocumentPageNumber整个工作簿中从 1 开始的页码
SheetPageNumber所属工作表内从 1 开始的页码
PageWidth / PageHeight应用方向后以磅为单位的纸张尺寸
Margins以磅为单位的左、右、上、下、页眉和页脚边距
Scale从 0.1 到 4 的已解析工作表缩放或适应页面缩放
Rows / RowEdges实际工作表行及其自上而下的页面坐标
Columns / ColumnEdges实际工作表列及其从左到右的页面坐标
Drawings分页时被页面裁剪的图像、图表、文本框、形状和控件位置
PrintComments分页输出的批注渲染模式；xpcAtEnd 会在工作表最后一页的最后一条数据行下方追加批注列表（单元格地址、作者和内容），xpcNone 则省略批注

渲染与图元文件

RenderPage 把一页绘制到任意 VCL TCanvas 中，并将页面按比例缩放到调用方提供的边界内

RenderPageToBackend 把一页绘制到 TXLSGraphicsBackend；RenderXlsxCellsToBackend 为一个逻辑页绘制感知样式的 XLSX 单元格层（纯色填充、折叠边框、逐单元格的字体/颜色/对齐、缩小以适应，以及溢出到相邻空单元格的文本）

CreatePageMetafile 返回一个由调用方拥有的 TMetafile，而 SavePageAsMetafile 把一页直接写入 EMF 文件

TXLSPDFExport.CreatePaginationModel 返回以导出器的方向、边距和行高默认值配置的同一模型，返回的模型归调用方所有

示例

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

另请参阅