管理分页
根据定义,分页是文本流中一页结束并另一页开始的地方。 Microsoft Excel允许用户在工作表的任何选定单元格中添加分页。
分页符添加在单元格位置后,页面结束并在打印时分页符后的数据打印在下一页。简单地说,分页符根据您的设定将工作表分成多页。您还可以在运行时使用 Aspose.Cells 添加分页符。Aspose.Cells 允许开发人员添加两种分页符:
- 水平分页
- 垂直分页
在接下来的讨论中,我们将描述如何使用Aspose.Cells向工作表添加水平或垂直分页。
分页
Aspose.Cells 提供了一个代表 Excel 文件的 Workbook 类。Workbook 类包含一个 Worksheets 集合,允许访问 Excel 文件中的每个工作表。
工作表由 Worksheet 类表示。Worksheet 类提供了用于管理工作表的广泛的属性和方法。
要添加分页符,使用 Worksheet 类的 HorizontalPageBreaks 和 VerticalPageBreaks 属性。
HorizontalPageBreaks 和 VerticalPageBreaks 属性是可能包含多个分页符的集合。每个集合都包含用于管理水平和垂直分页符的几种方法。
添加分页
要在工作表中添加分页符,通过调用 HorizontalPageBreakCollection.Add() 和 VerticalPageBreakCollection.Add() 方法,在指定的单元格插入垂直和水平分页符。每个 Add 方法都会取添加分页符的单元格名称。
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Instantiating a Workbook object | |
Workbook workbook = new Workbook(); | |
// Add a page break at cell Y30 | |
workbook.Worksheets[0].HorizontalPageBreaks.Add("Y30"); | |
workbook.Worksheets[0].VerticalPageBreaks.Add("Y30"); | |
// Save the Excel file. | |
workbook.Save(dataDir + "AddingPageBreaks_out.xls"); |
清除所有分页符
要清除工作表中的所有分页符,调用 HorizontalPageBreakCollection 和 VerticalPageBreakCollection 集合的 Clear() 方法。
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Instantiating a Workbook object | |
Workbook workbook = new Workbook(); | |
// Clearing all page breaks | |
workbook.Worksheets[0].HorizontalPageBreaks.Clear(); | |
workbook.Worksheets[0].VerticalPageBreaks.Clear(); | |
// Save the Excel file. | |
workbook.Save(dataDir + "ClearAllPageBreaks_out.xls"); |
移除特定的分页符
要移除特定分页符,调用 HorizontalPageBreakCollection.RemoveAt() 和 VerticalPageBreakCollection.RemoveAt() 方法。每个 RemoveAt 方法都会取要移除的分页符的索引。
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Instantiating a Workbook object | |
Workbook workbook = new Workbook(dataDir + "PageBreaks.xls"); | |
// Removing a specific page break | |
workbook.Worksheets[0].HorizontalPageBreaks.RemoveAt(0); | |
workbook.Worksheets[0].VerticalPageBreaks.RemoveAt(0); | |
// Save the Excel file. | |
workbook.Save(dataDir + "RemoveSpecificPageBreak_out.xls"); |
重要提示
当您在页面设置中设置 FitToPages 属性(即 FitToPagesTall 和 FitToPagesWide)时,分页符设置会受影响,因此,如果您打印工作表,分页符设置不会考虑,尽管它们仍然被设置。