Aspose::Words::DocumentBuilder::EndBookmark method

DocumentBuilder::EndBookmark method

Помечает текущую позицию в документе как конец закладки.

System::SharedPtr<Aspose::Words::BookmarkEnd> Aspose::Words::DocumentBuilder::EndBookmark(const System::String &bookmarkName)
ПараметрТипОписание
bookmarkNameconst System::String&Имя закладки.

ReturnValue

Узел конца закладки, который только что был создан.

Примечания

Закладки в документе могут перекрываться и охватывать любой диапазон. Чтобы создать действительную закладку, необходимо вызвать как StartBookmark(), так и EndBookmark() с одинаковым параметром bookmarkName.

Некорректно сформированные закладки или закладки с дублирующимися именами будут игнорироваться при сохранении документа.

Примеры

Показывает, как создать закладку.

auto doc = System::MakeObject<Aspose::Words::Document>();
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);

// Действительная закладка должна иметь текст тела документа, заключённый в
// Узлы BookmarkStart и BookmarkEnd, созданные с соответствующим именем закладки.
builder->StartBookmark(u"MyBookmark");
builder->Writeln(u"Hello world!");
builder->EndBookmark(u"MyBookmark");

ASSERT_EQ(1, doc->get_Range()->get_Bookmarks()->get_Count());
ASSERT_EQ(u"MyBookmark", doc->get_Range()->get_Bookmarks()->idx_get(0)->get_Name());
ASSERT_EQ(u"Hello world!", doc->get_Range()->get_Bookmarks()->idx_get(0)->get_Text().Trim());

Показывает, как вставить гиперссылку, ссылающуюся на локальную закладку.

auto doc = System::MakeObject<Aspose::Words::Document>();
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);

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

// Вставьте поле HYPERLINK, которое ссылается на закладку. Мы можем передать переключатели поля
// в метод "InsertHyperlink" в качестве части аргумента, содержащего имя ссылочной закладки.
builder->get_Font()->set_Color(System::Drawing::Color::get_Blue());
builder->get_Font()->set_Underline(Aspose::Words::Underline::Single);
auto hyperlink = System::ExplicitCast<Aspose::Words::Fields::FieldHyperlink>(builder->InsertHyperlink(u"Link to Bookmark1", u"Bookmark1", true));
hyperlink->set_ScreenTip(u"Hyperlink Tip");

doc->Save(get_ArtifactsDir() + u"DocumentBuilder.InsertHyperlinkToLocalBookmark.docx");

См. также

Метод Aspose::Words::DocumentBuilder::DeleteRow Aspose::Words::DocumentBuilder::EndColumnBookmark method