Робота з закладками

Закладки визначають у документі Microsoft Word місця або фрагменти, які ви вказуєте та ідентифікуєте для подальшого використання. Наприклад, ви можете використовувати закладку для визначення тексту, який ви хочете переглянути пізніше. Замість того, щоб прокручувати документ у пошуках потрібного тексту, ви можете перейти до нього за допомогою діалогового вікна “Закладки”.

Дії, які можна виконати із закладками за допомогою Aspose.Words, подібні до тих, які можна виконати за допомогою Microsoft Word. Ви можете вставити нову закладку, Видалити, Перемістити в закладку, отримати або задати назву закладки, отримати або задати текст, укладений в ній. За допомогою Aspose.Words ви також можете використовувати закладки у звітах або документах, щоб вставити в них деякі дані або застосувати спеціальне форматування до їх вмісту. Ви також можете використовувати закладки для вилучення тексту з певного місця у вашому документі.

Вставити закладку

Використовуйте StartBookmark та EndBookmark для створення закладки, позначивши її початок та кінець відповідно. Не забудьте вказати однакову назву закладки в обох методах. Закладки в документі можуть перекриватися і охоплювати будь-який діапазон. Неправильно оформлені закладки або закладки з повторюваними назвами будуть проігноровані при збереженні документа.

Наступний приклад коду показує, як створити нову закладку:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
// The path to the documents directory.
System::String outputDataDir = GetOutputDataDir_WorkingWithBookmarks();

System::SharedPtr<Document> doc = System::MakeObject<Document>();
System::SharedPtr<DocumentBuilder> builder = System::MakeObject<DocumentBuilder>(doc);

builder->StartBookmark(u"My Bookmark");
builder->Writeln(u"Text inside a bookmark.");

builder->StartBookmark(u"Nested Bookmark");
builder->Writeln(u"Text inside a NestedBookmark.");
builder->EndBookmark(u"Nested Bookmark");

builder->Writeln(u"Text after Nested Bookmark.");
builder->EndBookmark(u"My Bookmark");

System::SharedPtr<PdfSaveOptions> options = System::MakeObject<PdfSaveOptions>();
options->get_OutlineOptions()->get_BookmarksOutlineLevels()->Add(u"My Bookmark", 1);
options->get_OutlineOptions()->get_BookmarksOutlineLevels()->Add(u"Nested Bookmark", 2);

System::String outputPath = outputDataDir + u"CreateBookmark.pdf";
doc->Save(outputPath, options);

Отримувати закладки

Іноді необхідно отримати колекцію закладок для перебору закладок або для інших цілей. Використовуйте властивість Node.Range, надану будь-яким вузлом документа, який повертає об’єкт Range, Що представляє частину документа, що міститься в цьому вузлі. Використовуйте цей об’єкт для вилучення BookmarkCollection, а потім використовуйте індексатор колекції, щоб отримати певну закладку.

Наступний приклад коду показує, як отримати закладки з колекції закладок:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
// The path to the documents directory.
System::String inputDataDir = GetInputDataDir_WorkingWithBookmarks();

System::SharedPtr<Document> doc = System::MakeObject<Document>(inputDataDir + u"Bookmarks.doc");

// By index.
System::SharedPtr<Bookmark> bookmark1 = doc->get_Range()->get_Bookmarks()->idx_get(0);

// By name.
System::SharedPtr<Bookmark> bookmark2 = doc->get_Range()->get_Bookmarks()->idx_get(u"Bookmark2");

У наступному прикладі коду показано, як отримати або задати назву закладки і текст:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
// The path to the documents directory.
System::String inputDataDir = GetInputDataDir_WorkingWithBookmarks();

System::SharedPtr<Document> doc = System::MakeObject<Document>(inputDataDir + u"Bookmark.doc");

// Use the indexer of the Bookmarks collection to obtain the desired bookmark.
System::SharedPtr<Bookmark> bookmark = doc->get_Range()->get_Bookmarks()->idx_get(u"MyBookmark");

// Get the name and text of the bookmark.
System::String name = bookmark->get_Name();
System::String text = bookmark->get_Text();

// Set the name and text of the bookmark.
bookmark->set_Name(u"RenamedBookmark");
bookmark->set_Text(u"This is a new bookmarked text.");

Наступний приклад коду показує, як додати таблицю в закладки:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
// Create empty document
System::SharedPtr<Document> doc = System::MakeObject<Document>();
System::SharedPtr<DocumentBuilder> builder = System::MakeObject<DocumentBuilder>(doc);

System::SharedPtr<Table> table = builder->StartTable();

// Insert a cell
builder->InsertCell();

// Start bookmark here after calling InsertCell
builder->StartBookmark(u"MyBookmark");

builder->Write(u"This is row 1 cell 1");

// Insert a cell
builder->InsertCell();
builder->Write(u"This is row 1 cell 2");

builder->EndRow();

// Insert a cell
builder->InsertCell();
builder->Writeln(u"This is row 2 cell 1");

// Insert a cell
builder->InsertCell();
builder->Writeln(u"This is row 2 cell 2");

builder->EndRow();

builder->EndTable();
// End of bookmark
builder->EndBookmark(u"MyBookmark");

System::String outputPath = outputDataDir + u"BookmarkTable.doc";
doc->Save(outputPath);

Якщо ви зміните назву закладки на ім’я, яке вже існує в документі, помилка не буде згенерована, і при збереженні документа буде збережена тільки перша закладка.

Зверніть увагу, що деякі закладки в документі призначені полям форми. При переході до такої закладки і вставці тексту в неї текст буде вставлений в код поля форми. Хоча це не призведе до анулювання поля форми, вставлений текст не буде видно, оскільки він стане частиною коду поля.

Перейти до закладки

Якщо вам потрібно вставити розширений вміст (а не просто звичайний текст) у закладку, Вам слід використовувати MoveToBookmark для переміщення курсору на закладку, а потім використовувати методи та властивості DocumentBuilder’s для вставки вмісту.

Показувати і приховувати вміст закладок

Вся закладка (including the bookmarked content) може бути укладена в істинну частину поля IF за допомогою Aspose.Words. Це може бути так, що поле IF містить вкладене поле об’єднання у виразі (Left of Operator), і залежно від значення поля об’єднання поле IF відображає або приховує вміст закладки в документі Word.

Наступний приклад коду показує, як показувати / приховувати закладки:

For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
typedef System::SharedPtr<System::Object> TObjectPtr;

System::String bookmarkName = u"Bookmark2";

// The path to the documents directory.
System::String inputDataDir = GetInputDataDir_WorkingWithBookmarks();
System::String outputDataDir = GetOutputDataDir_WorkingWithBookmarks();

System::SharedPtr<Document> doc = System::MakeObject<Document>(inputDataDir + u"Bookmarks.doc");
System::SharedPtr<DocumentBuilder> builder = System::MakeObject<DocumentBuilder>(doc);
System::SharedPtr<Bookmark> bm = doc->get_Range()->get_Bookmarks()->idx_get(bookmarkName);

builder->MoveToDocumentEnd();
// {IF "{MERGEFIELD bookmark}" = "true" "" ""}
System::SharedPtr<Field> field = builder->InsertField(u"IF \"", nullptr);
builder->MoveTo(field->get_FieldStart()->get_NextSibling());
builder->InsertField(System::String(u"MERGEFIELD ") + bookmarkName + u"", nullptr);
builder->Write(u"\" = \"true\" ");
builder->Write(u"\"");
builder->Write(u"\"");
builder->Write(u" \"\"");

System::SharedPtr<Node> currentNode = field->get_FieldStart();
bool flag = true;
while (currentNode != nullptr && flag)
{
    if (currentNode->get_NodeType() == Aspose::Words::NodeType::Run)
    {
        if (System::ObjectExt::Equals(currentNode->ToString(Aspose::Words::SaveFormat::Text).Trim(), u"\""))
        {
            flag = false;
        }
    }

    System::SharedPtr<Node> nextNode = currentNode->get_NextSibling();

    bm->get_BookmarkStart()->get_ParentNode()->InsertBefore(currentNode, bm->get_BookmarkStart());
    currentNode = nextNode;
}

System::SharedPtr<Node> endNode = bm->get_BookmarkEnd();
flag = true;
while (currentNode != nullptr && flag)
{
    if (currentNode->get_NodeType() == Aspose::Words::NodeType::FieldEnd)
    {
        flag = false;
    }

    System::SharedPtr<Node> nextNode = currentNode->get_NextSibling();

    bm->get_BookmarkEnd()->get_ParentNode()->InsertAfter(currentNode, endNode);
    endNode = currentNode;
    currentNode = nextNode;
}

doc->get_MailMerge()->Execute(System::MakeArray<System::String>({bookmarkName}), System::MakeArray<TObjectPtr>({System::ObjectExt::Box<bool>(false)}));

//MailMerge can be avoided by using the following
//builder.MoveToMergeField(bookmarkName);
//builder.Write(showHide ? "true" : "false");

doc->Save(outputDataDir + u"Updated_Document_out.doc");