PreferredWidth

PreferredWidth class

表示一个值及其测量单位，用于指定表格或单元格的首选宽度。

要了解更多信息，请访问使用表格文档文章。

public sealed class PreferredWidth

特性

姓名描述
Type { get; }获取用于此首选宽度值的测量单位。
Value { get; }获取首选宽度值。测量单位在中指定Type属性.

方法

姓名描述
static FromPercent(double)一种创建方法，返回一个新实例，该实例表示指定为百分比的首选宽度。
static FromPoints(double)一种创建方法，返回一个新实例，该实例表示使用多个点指定的首选宽度。
override Equals(object)确定指定对象的值是否等于当前对象。
Equals(PreferredWidth)判断是否指定PreferredWidth与当前值相等PreferredWidth.
override GetHashCode()用作此类型的哈希函数。
override ToString()返回一个用户友好的字符串，显示该对象的值。

字段

姓名描述
static readonly Auto返回一个表示“未指定首选宽度”值的实例。

评论

首选宽度可以指定为百分比、点数或特殊的“无/自动”值。

该类的实例是不可变的。

例子

演示如何将表格设置为自动适合页面宽度的 50%。

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

Table table = builder.StartTable();
builder.InsertCell();
builder.Write("Cell #1");
builder.InsertCell();
builder.Write("Cell #2");
builder.InsertCell();
builder.Write("Cell #3");

table.PreferredWidth = PreferredWidth.FromPercent(50);

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

演示如何设置表格单元格的首选宽度。

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Table table = builder.StartTable();

// 有两种方法将“PreferredWidth”类应用于表格单元格。
// 1 - 根据点设置绝对首选宽度：
builder.InsertCell();
builder.CellFormat.PreferredWidth = PreferredWidth.FromPoints(40);
builder.CellFormat.Shading.BackgroundPatternColor = Color.LightYellow;
builder.Writeln($"Cell with a width of {builder.CellFormat.PreferredWidth}.");

// 2 - 根据表格宽度的百分比设置相对首选宽度：
builder.InsertCell();
builder.CellFormat.PreferredWidth = PreferredWidth.FromPercent(20);
builder.CellFormat.Shading.BackgroundPatternColor = Color.LightBlue;
builder.Writeln($"Cell with a width of {builder.CellFormat.PreferredWidth}.");

builder.InsertCell();

// 未指定首选宽度的单元格将占用剩余的可用空间。
builder.CellFormat.PreferredWidth = PreferredWidth.Auto;

// “PreferredWidth”属性的每个配置都会创建一个新对象。
Assert.AreNotEqual(table.FirstRow.Cells[1].CellFormat.PreferredWidth.GetHashCode(),
    builder.CellFormat.PreferredWidth.GetHashCode());

builder.CellFormat.Shading.BackgroundPatternColor = Color.LightGreen;
builder.Writeln("Automatically sized cell.");

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

也可以看看

CellVerticalAlignment Enum PreferredWidthType Enum