StartColumnBookmark

DocumentBuilder.StartColumnBookmark method

将文档中的当前位置标记为列书签的起始位置。该位置必须位于表格单元格中。

public BookmarkStart StartColumnBookmark(string bookmarkName)
范围类型描述
bookmarkNameString书签的名称。

返回值

刚刚创建的书签起始节点。

评论

列书签涵盖行范围内的一列或多列。要创建有效的书签,您需要同时调用StartColumnBookmarkEndColumnBookmark具有相同 bookmarkName范围。

保存文档时,格式不正确的书签或名称重复的书签将被忽略。

插入的实际位置BookmarkStart节点可能与当前 document 构建器位置不同。

例子

展示如何创建列书签。

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

builder.StartTable();

builder.InsertCell();
// 单元格 1、2、4、5 将被添加书签。
builder.StartColumnBookmark("MyBookmark_1");
// 保存文档时,格式错误的书签或名称重复的书签将被忽略。
builder.StartColumnBookmark("MyBookmark_1");
builder.StartColumnBookmark("BadStartBookmark");
builder.Write("Cell 1");

builder.InsertCell();
builder.Write("Cell 2");

builder.InsertCell();
builder.Write("Cell 3");

builder.EndRow();

builder.InsertCell();
builder.Write("Cell 4");

builder.InsertCell();
builder.Write("Cell 5");
builder.EndColumnBookmark("MyBookmark_1");
builder.EndColumnBookmark("MyBookmark_1");

builder.InsertCell();
builder.Write("Cell 6");

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

doc.Save(ArtifactsDir + "Bookmarks.CreateColumnBookmark.docx");

也可以看看