Previous topicNext topic
Help > 开发指南 > Excel > API > 主要对象 > Cell单元格 >
单元格格式

正确的单元格格式可改善文档外观,并帮助用户更轻松地阅读、查找和理解数据。设置单元格格式时,可以指定字体设置、字符样式(粗体、斜体或下划线)、文本对齐方式、填充颜色等。本主题介绍以下概念:

有关条件格式的详细信息,请参阅本主题:条件格式示例。

文档主题

文档主题是一组字体、颜色和图形效果,可用于更改文档的整体外观。每个工作簿都有一个由 Workbook.Theme 属性返回的关联主题。您可以为文档使用自定义主题或更改预定义的主题颜色,如本主题中所述:如何:应用或修改工作簿主题。

单元格样式

样式是一组已命名的预定义单元格格式特征(字体设置、数字格式、内容对齐方式、单元格边框和填充颜色)。应用样式时,只需一个步骤即可将所有格式设置应用于单元格或单元格区域。

工作簿将所有可用样式保存在 StyleCollection 集合中,该集合可通过 Workbook.Styles 属性进行访问。默认情况下,此集合包含一组类似于 Microsoft® Excel® 中的内置单元格样式(包括默认情况下应用于工作簿中所有未格式单元格的“普通”样式)。所有内置样式的标识符都由 BuiltInStyleId 枚举器列出。

下图显示了 Microsoft® Excel® 中的样式库。

您可以执行以下操作,通过电子表格文档 API 管理工作簿的单元格样式集合。

有关示例,请参阅以下主题:如何:创建或修改样式。

注意

加载到 Workbook 对象中的 Excel 文档的所有自定义样式 都将自动添加到 Workbook 中。样式集合,可以通过其名称访问。

若要通过应用样式来设置单元格或单元格区域的格式,请将所需的 Style 对象分配给 CellRange.Style 属性。有关详细信息,请参阅此示例:如何:将样式应用于单元格或单元格区域。

直接单元格格式化

要更改单元格外观,您不仅可以应用样式,还可以直接为单个单元格或单元格区域设置所需的格式特征。这称为直接单元格格式。在 Microsoft® Excel® 中,可通过功能区界面或“设置单元格格式”对话框中使用直接单元格格式设置选项。

若要通过电子表格文档 API 执行直接单元格格式设置,请更改从格式设置接口继承的单元格或单元格区域属性(Formatting.Fill、Formatting.Font、Formatting.Alignment、Formatting.Borders 和 Formatting.NumberFormat)。 默认情况下,这些属性是根据应用于单元格的样式设置的。使用以下方法。

若要设置单个单元格的格式,请访问相应的 Cell 对象(请参见如何:访问工作表中的单元格)并修改其格式属性。
若要设置单元格范围的格式,请使用 CellRange.BeginUpdateFormatting - CellRange.EndUpdateFormatting 方法对访问和修改 Formatting 对象。
因此,从 Formatting 接口继承的 Cell 或 CellRange 对象的属性提供对为单元格或单元格区域指定的实际格式设置(包括由应用的样式和直接格式设置属性定义的特征)的访问。

样式标志

单元格的实际外观是由应用的样式和直接单元格格式设置指定的设置的组合。每种格式设置类型都提供一组标志 (Formatting.Flags)。每个标志对应于一组特定的格式属性。在设置单元格格式时,可以使用这些标志来控制是使用在应用的样式中指定的属性,还是直接为单元格指定的属性。

说明 属性说明 标志
Alignment 对齐 单元格内容、缩进和文本换行的水平和垂直对齐。 StyleFlags.Alignment
Borders 边界 单元格边框线样式和颜色。 StyleFlags.Borders
Fill 填充 单元格背景颜色。 StyleFlags.Fill
Font 字体 单元格字体设置(名称、样式、颜色和大小)。 StyleFlags.Font
Number Format 数字格式 单元格编号格式。 StyleFlags.Number
Protection 保护 单元格保护选项(锁定和隐藏)。 StyleFlags.Protection

富文本格式

工作表中的单元格可以包含由 RichTextString 对象指定的格式丰富的文本。富文本由一个或多个文本区域(或文本运行)组成,每个区域都有自己的一组字体特征。单个文本运行由 RichTextRun 对象定义,并存储在 RichTextString.Runs 集合中。

您可以按如下方式将富格式应用于单元格文本:

将 RichTextString 实例传递给 CellRange.SetRichText 方法,以将格式文本分配给单元格。

有关如何将不同字体应用于单元格文本的所需区域的示例,请参阅以下主题:如何:对单元格文本应用丰富格式。

例子

以下示例说明如何使用电子表格文档 API 设置工作表单元格的格式: