当工作表需要打印时，ReoGrid会自动执行分页操作。分页过程会扫描工作表，并根据分页设置决定每页的打印范围。例如下图展示了一个垂直分页的工作表：
与Excel类似，ReoGrid会计算每页能容纳的最大单元格数量，无法完整打印的单元格会自动移至下一页：
任何时候都可以执行自动分页或重置当前分页符：
sheet1.AutoSplitPage();
该方法执行速度极快（<10ms），但如果默认打印机是网络打印机，获取纸张尺寸可能会耗时超过100ms（取决于网络环境）。
要在屏幕上显示分页线：
sheet1.EnableSettings(ReoGrid.WorksheetSettings.View_ShowPageBreaks);
效果：
如果未指定打印范围，ReoGrid会自动检测已使用的单元格区域作为打印范围：
通过工作表的PrintableRange属性可以修改打印范围：
// 构造参数为(行,列,行数,列数)
sheet1.PrintableRange = ReoGrid.RangePosition(1, 1, 9, 9);
如果打印范围超过纸张尺寸，会自动分页。超出打印范围的单元格不会被打印。
通过PrintSettings.PageOrder属性可以修改分页方向：
// 设置分页顺序为"先下后右"
sheet1.PrintSettings.PageOrder = ReoGrid.PrintPageOrder.DownThenOver;
通过工作表的PrintSettings属性可以修改纸张设置：
// 设置为横向打印
sheet1.PrintSettings.Landscape = true;
// 设置页边距为5个单位
sheet1.PrintSettings.Margins = ReoGrid.PageMargins(5);
示例：横向自动分页效果：
通过PrintSettings.PageScaling属性可以设置打印缩放比例：
// 缩放至70%
sheet1.PrintSettings.PageScaling = 0.7;
修改缩放比例后，工作表会自动重新分页。
通过工作表的RowPageBreaks和ColumnPageBreaks属性可以插入分页符：
// 在第5列插入垂直分页符
sheet1.ColumnPageBreaks.Add(5);
表格被分割为两页：
分页符有两种类型：实线表示用户分页符（通过AutoSplitPage方法或用户操作生成）；虚线表示系统分页符（由ReoGrid自动插入）：
要修改分页符位置（无论是系统还是用户分页符），可以使用以下方法：
// 修改列分页符位置
sheet1.ChangeColumnPageBreak(旧位置, 新位置);
// 修改行分页符位置
sheet1.ChangeRowPageBreak(旧位置, 新位置);
分页符被修改后将变为用户分页符，不再由ReoGrid自动更新。
通过工作表的IteratePrintPages方法可以遍历所有打印页，该方法返回每页的范围：
sheet1.IteratePrintPages( function(range){
console.log("页面范围：" ++ range.ToAddress());
return true;
});
输出示例：
页面范围：A1:E11
页面范围：F1:K11
可以指定遍历顺序：
sheet1.IteratePrintPages(
ReoGrid.PrintPageOrder.OverThenDown,
function(range){
// 处理逻辑
}
);
如未指定顺序，则使用打印设置中的分页顺序。
要禁止用户通过鼠标调整分页符位置：
sheet1.SetSettings(
ReoGrid.WorksheetSettings.Behavior_AllowUserChangingPageBreaks,
false
);
打印会话用于打印整个工作簿或指定工作表。打印整个工作簿或多个工作表时，从控件实例创建工作簿打印会话；打印单个工作表时，从该工作表创建会话。
var session = sheet1.CreatePrintSession();
session.Print();
var session = reoGridControl.CreatePrintSession();
session.Print();
var session = reoGridControl.CreatePrintSession();
session.Worksheets.Clear();
session.Worksheets.Add(grid.Worksheets["Sheet1"]);
session.Worksheets.Add(grid.Worksheets["Sheet3"]);
session.Print();
以下代码显示标准.NET打印预览对话框：
var sheet1 = reoGridControl.CurrentWorksheet;
var session = sheet1.CreatePrintSession();
try {
import System.Windows.Forms;
var ppd = System.Windows.Forms.PrintPreviewDialog();
ppd.Document = session.PrintDocument;
ppd.SetBounds(200, 200, 1024, 768);
ppd.PrintPreviewControl.Zoom = 1.0;
ppd.ShowDialog(winform);
}
finally {
session.Dispose();
}
使用默认设置打印工作表：
var session = sheet1.CreatePrintSession();
session.Print();
显示标准打印对话框后打印指定工作表：
import System.Windows.Forms;
var doc = null;
try {
doc = sheet1.CreatePrintSession().PrintDocument;
var pd = System.Windows.Forms.PrintDialog();
pd.Document = doc;
pd.UseEXDialog = true; // 64位Windows系统
if(pd.ShowDialog(winform) == System.Windows.Forms.DialogResult.OK) {
doc.PrinterSettings = pd.PrinterSettings;
doc.Print();
}
}
catch(e) {
win.msgbox(e.message, "打印错误");
}
finally {
if(doc) doc.Dispose();
}
import System.Windows.Forms;
var psd = System.Windows.Forms.PageSetupDialog();
try {
// 将ReoGrid页面设置转换为系统页面设置
psd.PageSettings = sheet1.PrintSettings.CreateSystemPageSettings();
psd.AllowMargins = true;
psd.AllowPrinter = true;
psd.AllowPaper = true;
psd.EnableMetric = true;
if(psd.ShowDialog(winform) == System.Windows.Forms.DialogResult.OK) {
// 将系统设置转换回ReoGrid设置
sheet1.PrintSettings.ApplySystemPageSettings(psd.PageSettings);
}
}
finally {
psd.Dispose();
}
附：unvell.ReoGrid.Print.PrintSettings 的 C# 源码中公开的属性如下：
namespace unvell.ReoGrid.Print;
public class PrintSettings : ICloneable{
public string PrinterName { get; set; }
public PrintPageOrder PageOrder { get; set; }
public bool ShowMargins { get; set; }
public bool ShowGridLines { get; set; }
public float PageScaling { get; set; }
public string PaperName { get; set; }
public bool Landscape { get; set; }
public float PaperWidth { get; set; }
public float PaperHeight { get; set; }
public PageMargins Margins { get; set; }
}