单元格格式

向单元格添加边框

Microsoft Excel允许用户通过添加边框来格式化单元格。

Microsoft Excel中的边框设置

todo:image_alt_text

边框的类型取决于添加的位置。例如,顶部边框是添加到单元格顶部位置的边框。用户还可以修改边框的线条样式和颜色。

使用Aspose.Cells,开发人员可以以与Microsoft Excel中相同灵活的方式添加边框并自定义其外观。

向单元格添加边框

Aspose.Cells提供了代表Microsoft Excel文件的Workbook类。Workbook类包含一个WorksheetCollection,允许访问Excel文件中的每个工作表。工作表由Worksheet类表示。Worksheet类提供了一个Cells集合。Cells集合中的每个项代表Cell类的对象。

Aspose.Cells在Cell类中提供了setStyle方法,用于设置单元格的格式样式。同时使用Style类的对象,提供用于配置字体设置的属性。

向单元格添加边框

使用Style类的setBorder方法向单元格添加边框。边框类型作为参数传递。所有边框类型均在BorderType枚举中预定义。

边框类型 描述
BOTTOM_BORDER 底部边框线
DIAGONAL_DOWN 从左上到右下对角线
DIAGONAL_UP 从左下到右上对角线
LEFT_BORDER 左边框线
RIGHT_BORDER 右边框线
TOP_BORDER 顶部边框线
HORIZONTAL 仅用于动态样式,例如条件格式设置。
VERTICAL 仅用于动态样式,例如条件格式设置。
要设置线条颜色,请使用Color枚举选择颜色,并将其传递给Style类的setBorder方法的Color参数。线条样式在CellBorderType枚举中预定义。
线条样式 描述
DASH_DOT 表示细虚线-点线
DASH_DOT_DOT 表示细虚线-点-点线
DASHED 表示虚线
DOTTED 表示点线
DOUBLE 表示双线
HAIR 表示发际线
MEDIUM_DASH_DOT 表示中等虚线-点线
MEDIUM_DASH_DOT_DOT 表示中等虚线-点-点线
MEDIUM_DASHED 表示中等虚线
NONE 表示无线条
MEDIUM 表示中等线
SLANTED_DASH_DOT 表示倾斜中等虚线-点线
THICK 表示粗线
THIN 表示细线
选择以上线条样式之一,然后将其分配给 Style 对象的 setBorder 方法。

执行以下代码时生成下面的输出。

应用于单元格四周的边框

todo:image_alt_text

向单元格范围添加边框

可以向单元格范围添加边框,而不仅仅是单个单元格。首先,通过调用 Cells 集合的 createRange 方法创建单元格范围,该方法接受以下参数:

  • 第一行,范围的第一行。
  • 第一列,范围的第一列。
  • 行数,范围内的行数。
  • 列数,范围内的列数。

createRange方法返回一个包含指定范围的Range对象。Range对象提供了一个setOutlineBorders方法,它接受以下参数:

  • CellBorderType,边框线样式,从CellBorderType枚举中选择。
  • Color,边框线颜色,从Color枚举中选择。

执行以下代码时生成下面的输出。

应用于单元格范围的边框

todo:image_alt_text

颜色和调色板

调色板是在创建图像时可用的颜色数量。在演示文稿中使用标准调色板可以让用户创建一致的外观。每个Microsoft Excel(97-2003)文件都有一个包含可应用于单元格、字体、网格线、图形对象、填充和图表中的线条的56种颜色的调色板。

Microsoft Excel中的调色板设置

todo:image_alt_text

通过Aspose.Cells不仅可以使用现有颜色,还可以使用自定义颜色。在使用自定义颜色之前,将其添加到调色板中。本主题解释了如何向调色板中添加自定义颜色。

向调色板中添加自定义颜色

Aspose.Cells还支持56种颜色的调色板。上面显示了标准颜色调色板。如果要使用在调色板中未定义的自定义颜色,则需要在使用之前将该颜色添加到调色板中。

Aspose.Cells提供了一个表示Microsoft Excel文件的类,称为Workbook。该类提供了changePalette方法,它接受以下参数以添加自定义颜色并修改调色板:

  • 自定义颜色,要添加到调色板中的自定义颜色。
  • 索引,将被自定义颜色替换的颜色的索引。应该在0-55之间。

下面的示例在应用于字体之前将一个自定义颜色添加到调色板中。

颜色和背景图案

Microsoft Excel可以设置单元格的前景(轮廓)和背景(填充)颜色以及背景图案,如下所示。

在Microsoft Excel中设置颜色和背景图案

todo:image_alt_text

Aspose.Cells还以灵活的方式支持这些功能。在本主题中,我们将学习如何使用Aspose.Cells来使用这些功能。

设置颜色和背景图案

Aspose.Cells 提供了一个类,Workbook,它表示 Microsoft Excel 文件。 Workbook 类包含一个WorksheetCollection,允许访问 Excel 文件中的每个工作表。 工作表由Worksheet类表示。 Worksheet 类提供一个Cells集合。 Cells集合中的每个项都表示Cell类的对象。

Aspose.Cells在Cell类中提供一个setStyle方法,用于设置单元格的格式。同时,可以使用Style类的对象来配置字体设置。

setForegroundColor属性设置单元格的底纹颜色。

setPattern属性指定单元格的前景或背景颜色所使用的背景图案。Aspose.Cells提供BackgroundType枚举,其中包含一组预定义的背景图案类型。

图案类型 描述
DIAGONAL_CROSSHATCH 表示对角线交叉图案
DIAGONAL_STRIPE 表示对角线条纹图案
GRAY_6 表示6.25%灰色图案
GRAY_12 表示12.5%灰色图案
GRAY_25 表示25%灰色图案
GRAY_50 表示50%灰色图案
GRAY_75 表示75%灰色图案
HORIZONTAL_STRIPE 表示水平条纹图案
NONE 表示无背景
REVERSE_DIAGONAL_STRIPE 代表着反斜纹样式
SOLID 代表着固体图案
THICK_DIAGONAL_CROSSHATCH 代表着粗对角交错图案
THIN_DIAGONAL_CROSSHATCH 代表着细对角交错图案
THIN_DIAGONAL_STRIPE 代表着细对角条纹图案
THIN_HORIZONTAL_CROSSHATCH 代表着细水平交错图案
THIN_HORIZONTAL_STRIPE 代表着细水平条纹图案
THIN_REVERSE_DIAGONAL_STRIPE 代表着细反斜纹条纹图案
THIN_VERTICAL_STRIPE 代表着细垂直条纹图案
VERTICAL_STRIPE 代表着垂直条纹图案
在下面的示例中,A1单元格的前景色已设置,但A2配置为具有前景色和背景色的垂直条纹背景模式。

执行代码时会生成以下输出。

在具有背景模式的单元格上应用前景色和背景色

todo:image_alt_text

重要知识

在单元格中格式化所选字符

处理字体设置解释了如何格式化单元格,但只是如何格式化整个单元格的内容。 如果您只想格式化所选字符该怎么办?

Aspose.Cells 支持此功能。本主题解释了如何使用此功能。

格式化所选字符

Aspose.Cells 提供了一个类,Workbook,它表示 Microsoft Excel 文件。 Workbook 类包含一个WorksheetCollection,允许访问 Excel 文件中的每个工作表。 工作表由Worksheet类表示。 Worksheet 类提供一个Cells集合。 Cells集合中的每个项都表示Cell类的对象。

Cell类提供了characters方法,接受以下参数以选择单元格中的字符范围:

  • 起始索引,从中开始选择的字符的索引。
  • 字符数,要选择的字符数。

在输出文件中,A1单元格中,“Visit”一词使用默认字体格式,但“Aspose!”是粗体和蓝色。

格式化所选字符

todo:image_alt_text

高级主题