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.");

// Вставляем поле ГИПЕРССЫЛКИ, которое ссылается на закладку. Мы можем передать переключатели полей
// методу "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