StartBookmark

DocumentBuilder.StartBookmark method

将文档中的当前位置标记为书签开始。

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

返回值

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

评论

文档中的书签可以重叠并跨越任何范围。要创建有效的书签，您需要 调用两者StartBookmark和EndBookmark与相同的bookmarkName 参数。

保存文档时，格式错误的书签或名称重复的书签将被忽略。

例子

展示如何创建书签。

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

// 有效的书签需要将文档正文文本括起来
// 使用匹配的书签名称创建的 BookmarkStart 和 BookmarkEnd 节点。
builder.StartBookmark("MyBookmark");
builder.Writeln("Hello world!");
builder.EndBookmark("MyBookmark");

Assert.AreEqual(1, doc.Range.Bookmarks.Count);
Assert.AreEqual("MyBookmark", doc.Range.Bookmarks[0].Name);
Assert.AreEqual("Hello world!", doc.Range.Bookmarks[0].Text.Trim());

演示如何插入引用本地书签的超链接。

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

builder.StartBookmark("Bookmark1");
builder.Write("Bookmarked text. ");
builder.EndBookmark("Bookmark1");
builder.Writeln("Text outside of the bookmark.");

// 插入链接到书签的 HYPERLINK 字段。我们可以通过现场开关
// 作为包含引用书签名称的参数的一部分发送到“InsertHyperlink”方法。
builder.Font.Color = Color.Blue;
builder.Font.Underline = Underline.Single;
builder.InsertHyperlink("Link to Bookmark1", @"Bookmark1"" \o ""Hyperlink Tip", true);

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

也可以看看

DocumentBuilder.PushFont DocumentBuilder.StartColumnBookmark