LayoutCollector

LayoutCollector class

此类允许计算文档节点的页码。

要了解更多信息，请访问转换为固定页面格式文档文章。

public class LayoutCollector

构造函数

姓名描述
LayoutCollector(Document)初始化此类的一个实例。

特性

姓名描述
Document { get; set; }获取或设置此收集器实例所附加的文档。

方法

姓名描述
Clear()清除所有收集的布局数据。手动更新文档或重建布局后调用此方法。
GetEndPageIndex(Node)获取节点结束页面的从 1 开始的索引。如果节点无法映射到页面，则返回 0。
GetEntity(Node)返回不透明位置LayoutEnumerator对应于指定的节点。 您可以使用返回值作为参数来Current给定被枚举的文档 和节点的文档是相同的。
GetNumPagesSpanned(Node)获取指定节点跨越的页面数。如果节点位于单个页面内，则为 0。 这与GetEndPageIndex-GetStartPageIndex.
GetStartPageIndex(Node)获取节点起始页面的从 1 开始的索引。如果节点无法映射到页面，则返回 0。

评论

当你创建一个LayoutCollector并指定Document要附加到的文档对象， 当文档被格式化为页面时，收集器将记录文档节点到布局对象的映射。

您将能够通过使用GetStartPageIndex，GetEndPageIndex和GetNumPagesSpanned方法。 这些方法会自动构建文档的页面布局模型，并根据需要更新字段。

当你不再需要收集布局信息时，最好设置Document财产无效的 以避免不必要地收集更多的布局映射。

例子

显示如何查看节点跨越的页面范围。

Document doc = new Document();
LayoutCollector layoutCollector = new LayoutCollector(doc);

// 调用“GetNumPagesSpanned”方法来计算我们的文档内容跨越了多少页。
// 由于文档为空，因此页数当前为零。
Assert.AreEqual(doc, layoutCollector.Document);
Assert.AreEqual(0, layoutCollector.GetNumPagesSpanned(doc));

// 用 5 页内容填充文档。
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Write("Section 1");
builder.InsertBreak(BreakType.PageBreak);
builder.InsertBreak(BreakType.PageBreak);
builder.InsertBreak(BreakType.SectionBreakEvenPage);
builder.Write("Section 2");
builder.InsertBreak(BreakType.PageBreak);
builder.InsertBreak(BreakType.PageBreak);

// 在布局收集器之前，我们需要调用“UpdatePageLayout”方法来给我们
// 任何与布局相关的指标的准确数字，例如页数。
Assert.AreEqual(0, layoutCollector.GetNumPagesSpanned(doc));

layoutCollector.Clear();
doc.UpdatePageLayout();

Assert.AreEqual(5, layoutCollector.GetNumPagesSpanned(doc));

// 我们可以看到任何节点的起始页和结束页的编号以及它们的总页面跨度。
NodeCollection nodes = doc.GetChildNodes(NodeType.Any, true);
foreach (Node node in nodes)
{
    Console.WriteLine($"->  NodeType.{node.NodeType}: ");
    Console.WriteLine(
        $"\tStarts on page {layoutCollector.GetStartPageIndex(node)}, ends on page {layoutCollector.GetEndPageIndex(node)}," +
        $" spanning {layoutCollector.GetNumPagesSpanned(node)} pages.");
}

// 我们可以使用 LayoutEnumerator 遍历布局实体。
LayoutEnumerator layoutEnumerator = new LayoutEnumerator(doc);

Assert.AreEqual(LayoutEntityType.Page, layoutEnumerator.Type);

// LayoutEnumerator 可以像树一样遍历布局实体集合。
// 我们还可以将其应用于任何节点对应的布局实体。
layoutEnumerator.Current = layoutCollector.GetEntity(doc.GetChild(NodeType.Paragraph, 1, true));

Assert.AreEqual(LayoutEntityType.Span, layoutEnumerator.Type);
Assert.AreEqual("¶", layoutEnumerator.Text);

也可以看看

IPageLayoutCallback Interface LayoutEntityType Enum