Aspose::Words::DocumentBuilder::StartColumnBookmark method

DocumentBuilder::StartColumnBookmark method

Помечает текущую позицию в документе как начало столбцовой закладки. Позиция должна находиться в ячейке таблицы.

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

ReturnValue

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

Примечания

Столбцовая закладка охватывает один или несколько столбцов в диапазоне строк. Чтобы создать корректную закладку, необходимо вызвать как StartColumnBookmark(), так и EndColumnBookmark() с одинаковым параметром bookmarkName.

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

Фактическая позиция вставленного узла BookmarkStart может отличаться от текущей позиции построителя документа.

Примеры

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

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

builder->StartTable();

builder->InsertCell();
// Ячейки 1,2,4,5 будут отмечены закладкой.
builder->StartColumnBookmark(u"MyBookmark_1");
// Некорректно сформированные закладки или закладки с дублирующимися именами будут игнорироваться при сохранении документа.
builder->StartColumnBookmark(u"MyBookmark_1");
builder->StartColumnBookmark(u"BadStartBookmark");
builder->Write(u"Cell 1");

builder->InsertCell();
builder->Write(u"Cell 2");

builder->InsertCell();
builder->Write(u"Cell 3");

builder->EndRow();

builder->InsertCell();
builder->Write(u"Cell 4");

builder->InsertCell();
builder->Write(u"Cell 5");
builder->EndColumnBookmark(u"MyBookmark_1");
builder->EndColumnBookmark(u"MyBookmark_1");

ASSERT_THROW(static_cast<std::function<void()>>([&builder]() -> void
{
    builder->EndColumnBookmark(u"BadEndBookmark");

builder->InsertCell();
builder->Write(u"Cell 6");

builder->EndRow();
builder->EndTable();

doc->Save(get_ArtifactsDir() + u"Bookmarks.CreateColumnBookmark.docx");

См. также

Aspose::Words::DocumentBuilder::StartBookmark метод Aspose::Words::DocumentBuilder::StartEditableRange метод