Class CellFormat

CellFormat class

表示表格单元格的所有格式。

public class CellFormat

特性

姓名描述
Borders { get; }获取单元格边框的集合。
BottomPadding { get; set; }返回或设置要添加到单元格内容下方的空间量（以磅为单位）。
FitText { get; set; }如果为真，则适合单元格中的文本，将每个段落压缩到单元格的宽度。
HorizontalMerge { get; set; }指定单元格如何与行中的其他单元格水平合并。
LeftPadding { get; set; }返回或设置要添加到单元格内容左侧的空间量（以磅为单位）。
Orientation { get; set; }返回或设置表格单元格中文本的方向。
PreferredWidth { get; set; }返回或设置单元格的首选宽度。
RightPadding { get; set; }返回或设置要添加到单元格内容右侧的空间量（以磅为单位）。
Shading { get; }返回一个 Shading 对象，该对象引用单元格的着色格式。
TopPadding { get; set; }返回或设置要添加到单元格内容之上的空间量（以磅为单位）。
VerticalAlignment { get; set; }返回或设置单元格中文本的垂直对齐方式。
VerticalMerge { get; set; }指定单元格如何垂直与其他单元格合并。
Width { get; set; }以点为单位获取单元格的宽度。
WrapText { get; set; }如果为真，则为单元格换行。

方法

姓名描述
ClearFormatting()重置为默认单元格格式。不改变单元格的宽度。
SetPaddings(double, double, double, double)设置要添加到单元格内容的左/上/右/下的空间量（以磅为单位）。

例子

显示如何修改表格单元格的格式。

Document doc = new Document(MyDir + "Tables.docx");
Table table = doc.FirstSection.Body.Tables[0];
Cell firstCell = table.FirstRow.FirstCell;

// 使用单元格的“CellFormat”属性设置修改该单元格外观的格式。
firstCell.CellFormat.Width = 30;
firstCell.CellFormat.Orientation = TextOrientation.Downward;
firstCell.CellFormat.Shading.ForegroundPatternColor = Color.LightGreen;

doc.Save(ArtifactsDir + "Table.CellFormat.docx");

显示如何修改表格中行和单元格的格式。

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Table table = builder.StartTable();
builder.InsertCell();
builder.Write("City");
builder.InsertCell();
builder.Write("Country");
builder.EndRow();
builder.InsertCell();
builder.Write("London");
builder.InsertCell();
builder.Write("U.K.");
builder.EndTable();

// 使用第一行的“RowFormat”属性修改格式
// 此行中所有单元格的内容。
RowFormat rowFormat = table.FirstRow.RowFormat;
rowFormat.Height = 25;
rowFormat.Borders[BorderType.Bottom].Color = Color.Red;

// 使用最后一行中第一个单元格的“CellFormat”属性来修改该单元格内容的格式。
CellFormat cellFormat = table.LastRow.FirstCell.CellFormat;
cellFormat.Width = 100;
cellFormat.Shading.BackgroundPatternColor = Color.Orange;

doc.Save(ArtifactsDir + "Table.RowCellFormat.docx");

演示如何构建具有自定义边框的表格。

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.StartTable();

// 为文档构建器设置表格格式选项
// 将它们应用于我们添加的每一行和单元格。
builder.ParagraphFormat.Alignment = ParagraphAlignment.Center;

builder.CellFormat.ClearFormatting();
builder.CellFormat.Width = 150;
builder.CellFormat.VerticalAlignment = CellVerticalAlignment.Center;
builder.CellFormat.Shading.BackgroundPatternColor = Color.GreenYellow;
builder.CellFormat.WrapText = false;
builder.CellFormat.FitText = true;

builder.RowFormat.ClearFormatting();
builder.RowFormat.HeightRule = HeightRule.Exactly;
builder.RowFormat.Height = 50;
builder.RowFormat.Borders.LineStyle = LineStyle.Engrave3D;
builder.RowFormat.Borders.Color = Color.Orange;

builder.InsertCell();
builder.Write("Row 1, Col 1");

builder.InsertCell();
builder.Write("Row 1, Col 2");
builder.EndRow();

// 更改格式会将其应用到当前单元格，
// 以及我们之后使用构建器创建的任何新单元格。
// 这不会影响我们之前添加的单元格。
builder.CellFormat.Shading.ClearFormatting();

builder.InsertCell();
builder.Write("Row 2, Col 1");

builder.InsertCell();
builder.Write("Row 2, Col 2");

builder.EndRow();

// 增加行高以适应垂直文本。
builder.InsertCell();
builder.RowFormat.Height = 150;
builder.CellFormat.Orientation = TextOrientation.Upward;
builder.Write("Row 3, Col 1");

builder.InsertCell();
builder.CellFormat.Orientation = TextOrientation.Downward;
builder.Write("Row 3, Col 2");

builder.EndRow();
builder.EndTable();

doc.Save(ArtifactsDir + "DocumentBuilder.InsertTable.docx");

也可以看看

Class CellCollection Enum CellMerge