页面设置功能

有时，需要为工作表配置页面设置以控制打印。这些页面设置选项提供各种选项。

页面选项

Aspose.Cells完全支持页面设置选项。本文说明了如何使用Aspose.Cells设置页面选项。

设置页面选项

Aspose.Cells提供一个代表Microsoft Excel文件的类，Workbook。Workbook类包含一个Worksheets集合，允许访问Excel文件中的每个工作表。工作表由Worksheet类表示。

Worksheet类提供PageSetup属性，用于设置页面设置选项。实际上，PageSetup属性是PageSetup类的对象，它可以设置打印工作表的页面布局选项。PageSetup类提供各种属性，用于设置页面设置选项。以下讨论了其中一些属性。

页面方向

可以使用PageSetup类的setOrientation(PageOrientationType)方法将页面方向设置为纵向或横向。setOrientation(PageOrientationType)方法接受PageOrientationType枚举作为参数。PageOrientationType枚举的成员列在下面。

页面方向类型	描述
横向	横向方向
纵向	纵向方向

缩放因子

可以通过PageSetup类的setZoom方法调整缩放因子以减小或放大工作表的大小。

适合页码选项

为了使工作表内容适合特定页数，使用PageSetup类的setFitToPagesTall和setFitToPagesWide方法。这些方法还用于缩放工作表。

纸张尺寸

使用PageSetup类的PaperSize属性设置工作表将要打印到的纸张尺寸。PaperSize属性接受PaperSizeType枚举中的预定义值之一。下面列出了这些值。

纸张尺寸类型	描述
Paper10x14	10 in. x 14 in.
Paper11x17	11 in. x 17 in.
PaperA3	A3 (297 mm x 420 mm)
PaperA4	A4 (210 mm x 297 mm)
PaperA4Small	A4 Small (210 mm x 297 mm)
PaperA5	A5 (148 mm x 210 mm)
PaperB3	B3 (13.9 x 19.7 inches)
PaperB4	B4 (250 mm x 354 mm)
PaperB5	B5 (182 mm x 257 mm)
PaperBusinessCard	Business Card (90 mm x 55 mm)
PaperCSheet	C size sheet
PaperDSheet	D size sheet
PaperEnvelope10	Envelope #10 (4-1/8 in. x 9-1/2 in.)
PaperEnvelope11	Envelope #11 (4-1/2 in. x 10-3/8 in.)
PaperEnvelope12	Envelope #12 (4-1/2 in. x 11 in.)
PaperEnvelope14	Envelope #14 (5 in. x 11-1/2 in.)
PaperEnvelope9	Envelope #9 (3-7/8 in. x 8-7/8 in.)
PaperEnvelopeB4	Envelope B4 (250 mm x 353 mm)
PaperEnvelopeB5	Envelope B5 (176 mm x 250 mm)
PaperEnvelopeB6	Envelope B6 (176 mm x 125 mm)
PaperEnvelopeC3	Envelope C3 (324 mm x 458 mm)
PaperEnvelopeC4	Envelope C4 (229 mm x 324 mm)
PaperEnvelopeC5	Envelope C5 (162 mm x 229 mm)
PaperEnvelopeC6	Envelope C6 (114 mm x 162 mm)
PaperEnvelopeC65	Envelope C65 (114 mm x 229 mm)
PaperEnvelopeDL	Envelope DL (110 mm x 220 mm)
PaperEnvelopeItaly	Envelope Italy (110 mm x 230 mm)
PaperEnvelopeMonarch	Envelope Monarch (3-7/8 in. x 7-1/2 in.)
PaperEnvelopePersonal	Envelope (3-5/8 in. x 6-1/2 in.)
PaperESheet	E size sheet
PaperExecutive	Executive (7-1/2 in. x 10-1/2 in.)
PaperFanfoldLegalGerman	German Legal Fanfold (8-1/2 in. x 13 in.)
PaperFanfoldStdGerman	German Standard Fanfold (8-1/2 in. x 12 in.)
PaperFanfoldUS	U.S. Standard Fanfold (14-7/8 in. x 11 in.)
PaperFolio	Folio (8-1/2 in. x 13 in.)
PaperLedger	Ledger (17 in. x 11 in.)
PaperLegal	Legal (8-1/2 in. x 14 in.)
PaperLetter	Letter (8-1/2 in. x 11 in.)
PaperLetterSmall	Letter Small (8-1/2 in. x 11 in.)
PaperNote	Note (8-1/2 in. x 11 in.)
PaperQuarto	Quarto (215 mm x 275 mm)
PaperStatement	Statement (5-1/2 in. x 8-1/2 in.)
PaperTabloid	Tabloid (11 in. x 17 in.)

打印质量

将工作表的打印质量设置为使用 PageSetup 类的 setPrintQuality 方法进行打印。打印质量的测量单位是每英寸点数（DPI）。

首页页码

使用 PageSetup 类的 setFirstPageNumber 方法开始对工作表页面进行编号。setFirstPageNumber 方法设置第一个工作表页面的页码，随后的页面按升序编号。

设置页边距

Aspose.Cells 完全支持微软 Excel 的页面设置选项。开发人员可能需要为工作表配置页面设置以控制打印过程。本主题讨论如何使用 Aspose.Cells 配置页面边距。

微软 Excel 中的页面边距

Aspose.Cells 提供了一个代表微软 Excel 文件的 Workbook 类。Workbook 类包含了允许访问 Excel 文件中每个工作表的 Worksheets 集合。工作表由 Worksheet 类表示。

Worksheet 类提供了 PageSetup 属性，用于设置页面设置选项。PageSetup 属性是 PageSetup 类的对象，使得可以为打印的工作表设置不同的页面布局选项。PageSetup 类提供了各种属性和方法，用于设置页面设置选项。

页面边距

使用 PageSetup 类的成员设置页面的边距（左、右、上、下）。以下列出了用于指定页面边距的一些方法：

• setLeftMargin(int)
• setRightMargin(int)
• setTopMargin(int)
• setBottomMargin(int)

页面居中

可以水平和垂直地将页面居中。PageSetup 类具有以下专门用于此目的的成员：setCenterHorizontally 和 setCenterVertically。

页眉和页脚边距

使用 PageSetup 类的成员设置页眉和页脚的边距，例如 setHeaderMargin 和 setFooterMargin。

设置页眉和页脚

页眉和页脚是页面上边缘之上或下边缘之下的文本和图像部分。还可以向工作表添加页眉和页脚。页眉和页脚可用于显示任何类型的有用信息，例如页码、作者姓名、文档标题或日期和时间。也可以使用页眉和页脚来管理 Page Setup 对话框中的内容。

页面设置对话框

Aspose.Cells 允许在运行时向工作表添加页眉和页脚，但建议手动在预设计的文件中设置页眉和页脚以供打印。您可以使用 Microsoft Excel 作为 GUI 工具轻松设置页眉和页脚，从而减少开发时间。Aspose.Cells 可以导入文件并保留这些设置。

要在运行时添加页眉和页脚，Aspose.Cells 提供了特殊的类和一些脚本命令来控制格式。

脚本命令

脚本命令是由Aspose.Cells提供的特殊命令，允许开发人员格式化页眉和页脚。

脚本命令	描述
&P	当前页面数字。
&G	图片。
&N	总页数。
&D	当前日期。
&T	当前时间。
&A	工作表名称。
&F	不带路径的文件名。
&"<FontName>"	字体名称。例如：&“Arial”
&"<FontName>, <FontStyle>"	带有样式的字体名称。例如：&“Arial,Bold”
&<FontSize>	代表字体大小。例如：“&14abc”。但如果此命令后跟一个要在页眉中打印的普通数字，则应与字体大小用空格分隔。例如：“&14 123”。

设置页眉和页脚

类PageSetup提供了添加页眉的方法setHeader和添加页脚的方法setFooter。该脚本被用作上述方法的参数。它表示用于页眉或页脚的脚本。此脚本包含用于格式化页眉或页脚的脚本命令。

在页眉或页脚中插入图形

The PageSetup类有方法setHeadPicture和setFooterPicture，用于向工作表的页眉和页脚添加图片。这些方法接受两个参数：

• 节，将放置图片的页眉或页脚的部分。有三个部分：左侧，中心和右侧，分别由数值0、1和2表示。
• 文件InputStream，图形数据。二进制数据应写入字节数组的缓冲区。

在执行代码并打开文件后，检查Microsoft Excel中的工作表页眉:

1. 在文件菜单上，选择页面设置。
2. 在页面设置对话框中，选择页眉/页脚选项卡。

在页眉/页脚中插入图形

仅在第一页页眉中插入图形

除了其他有用的方法，PageSetup类还有例如setPicture、setFirstPageHeader、setFirstPageFooter的方法，用于将图片添加到工作表的第一页页眉/页脚。第一页是一个特殊的页面：通常会希望它显示特殊信息，例如公司标志。

设置打印选项

Microsoft Excel的页面设置提供了几个打印选项（也称为工作表选项），允许用户控制工作表页面的打印方式。这些打印选项允许用户：

• 选择工作表上的特定打印区域。
• 打印标题。
• 打印网格线。
• 打印行和列标题
• 获得草稿质量。
• 打印注释。
• 打印单元格错误。
• 定义页面排序。

所有这些打印选项如下所示。

打印（工作表）选项

设置打印和工作表选项

spose.Cells支持Microsoft Excel提供的所有打印选项，开发人员可以轻松地使用PageSetup类提供的属性配置工作表的这些选项。下面更详细地讨论了这些属性的使用方式。

设置打印区域

默认情况下，只有打印区域包括所有包含数据的工作表区域。开发人员可以为工作表设定特定的打印区域。

要选择特定的打印区域，请使用 PageSetup 类的 setPrintArea 属性。将定义打印区域的单元范围分配给此属性。

设置打印标题

Aspose.Cells 允许您指定行列标题在打印工作表的所有页面上重复显示。要这样做，请使用 PageSetup 类的 setPrintTitleColumns 和 setPrintTitleRows 属性。

要重复显示的行或列是通过传递它们的行号或列号来定义的。例如，行被定义为 $1:$2，列被定义为 $A:$B。

设置其他打印选项

PageSetup 类还提供了几个其他属性来设置常规打印选项如下：

• setPrintGridlines，一个布尔属性，定义是否打印网格线或不打印。
• setPrintHeadings，一个布尔属性，定义是否打印行和列标题或不打印。
• setBlackAndWhite，一个布尔属性，定义是否以黑白模式打印工作表或不打印。
• setPrintComments，定义是否在工作表上显示打印备注或在工作表末尾显示。
• setPrintDraft，一个布尔属性，定义是否以草稿质量打印工作表或不打印。
• setPrintErrors，定义是否按照显示，空白，破折号或 N/A 打印单元格错误。

为了设置 PrintComments 和 PrintErrors 属性，Aspose.Cells 还提供了两个枚举，PrintCommentsType 和 PrintErrorsType，其中包含预定义的值分配给 setPrintComments 和 setPrintErrors 属性。

PrintCommentsType 枚举中的预定义值如下所述。

打印备注类型	描述
PRINT_IN_PLACE	指定按照工作表上显示的方式打印备注。
PRINT_NO_COMMENTS	指定不打印备注。
PRINT_SHEET_END	指定在工作表末尾打印备注。

PrintErrorsType 枚举中的预定义值如下所述。

打印错误类型	描述
PRINT_ERRORS_BLANK	指定不打印错误。
PRINT_ERRORS_DASH	指定打印错误为“–”。
PRINT_ERRORS_DISPLAYED	指定以显示形式打印错误。
PRINT_ERRORS_NA	指定打印错误为“＃N/A”。

设置页面顺序

PageSetup 类提供 setOrder 属性，用于对要打印的工作表的多个页面进行排序。有两种可能的页面排序方式如下：

• 先向下再向右 打印所有页面向下后再打印任何页面向右。
• 先向右再向下 依次打印页面从左到右再打印页面向下。

Aspose.Cells 提供一个枚举，PrintOrderType，其中包含所有预定义的排序类型，可分配给 setOrder 方法。

PrintOrderType 枚举的预定义值如下所述。

打印顺序类型	描述
DOWN_THEN_OVER	先向下，再向右打印。
OVER_THEN_DOWN	先向右，再向下打印。

删除Excel文件中工作表的现有打印设置

请参阅与此主题相关的文章。

高级主题

• 计算页面设置缩放因子
• 将源工作表中的页面设置复制到目标工作表
• 确定工作表的纸张大小是否自动
• 从工作表的页面设置获取纸张的宽度和高度
• 实现工作表的自定义纸张大小以进行渲染
• 页面设置和打印选项
• 删除Excel文件中工作表的现有打印设置