Microsoft Word 使您能夠向 Word 文檔添加註釋。在建議改進文檔或分享對文本的想法等情況下，評論會很有幫助。在某些情況下，您可能需要以編程方式管理評論。為此，本文將教您如何使用 C++ 在 Word 文檔中處理註釋。
- 用於在 Word 文檔中處理註釋的 C++ API
- 使用 C++ 向 Word 文檔添加註釋
- 從 Word 文檔中讀取註釋
- 使用 C++ 修改 Word 文檔中的註釋
- 使用 C++ 從 Word 文檔中刪除註釋
用於在 Word 文檔中處理註釋的 C++ API
Aspose.Words for C++ 是一個本地 C++ 庫，允許您創建、讀取、修改和轉換 Microsoft Word 文檔。此外，它還支持處理 DOCX 和 DOC 文件中的註釋。您可以通過 NuGet 安裝 API 或直接從 下載 部分下載。
PM> Install-Package Aspose.Words.Cpp
使用 C++ 向 Word 文檔添加註釋
Aspose.Words for C++ API 提供了添加帶有作者姓名、首字母和日期/時間的評論的能力。以下是在 Word 文檔中添加批註的步驟。
- 首先，使用 Document 類加載 Word 文檔。
- 通過傳遞在上一步中創建的 Document 對象來創建 DocumentBuilder 類的實例。
- 使用 Comment 類創建評論。
- 使用 DocumentBuilder->getCurrentParagraph()->AppendChild(System::SharedPtrAspose::Words::Node newChild) 方法。
- 最後，使用 Document->Save(System::String fileName) 方法保存文檔。
下面的示例代碼演示瞭如何使用 C++ 向 Word 文檔添加註釋。
// 目錄路徑。
System::String sourceDataDir = u"SourceDirectory\\";
System::String outputDataDir = u"OutputDirectory\\";
// 加載Word文件
System::SharedPtr<Document> doc = System::MakeObject<Document>(sourceDataDir + u"Sample 1.docx");
// 創建 DocumentBuilder 類的實例
System::SharedPtr<DocumentBuilder> builder = System::MakeObject<DocumentBuilder>(doc);
// 添加評論
System::SharedPtr<Comment> comment = System::MakeObject<Comment>(doc, u"Aspose", u"AFFA", System::DateTime::get_Today());
builder->get_CurrentParagraph()->AppendChild(comment);
comment->get_Paragraphs()->Add(System::MakeObject<Paragraph>(doc));
comment->get_FirstParagraph()->get_Runs()->Add(System::MakeObject<Run>(doc, u"Comment text."));
// 保存文檔。
doc->Save(outputDataDir + u"AddCommentsToExistingDoc.docx");
以下是示例代碼生成的輸出圖像。
從 Word 文檔中讀取註釋
以下是從 Word 文檔中讀取批註的步驟。
- 使用 Document 類加載 Word 文檔。
- 使用 Document->GetChildNodes(Aspose::Words::NodeType nodeType, bool isDeep) 方法檢索評論。
- 遍歷評論並檢索各個評論的信息。
以下是使用 C++ 從 Word 文檔中讀取註釋的示例代碼。
// 目錄路徑。
System::String sourceDataDir = u"SourceDirectory\\";
System::String outputDataDir = u"OutputDirectory\\";
// 加載Word文件
System::SharedPtr<Document> doc = System::MakeObject<Document>(sourceDataDir + u"SampleComments.docx");
// 檢索評論
System::SharedPtr<NodeCollection> comments = doc->GetChildNodes(NodeType::Comment, true);
// 遍歷所有評論
for (System::SharedPtr<Comment> comment : System::IterateOver<System::SharedPtr<Comment>>(comments))
{
// 打印評論信息
std::cout << comment->get_Author() + u" " + comment->get_DateTime() + u" " + System::StaticCast<Node>(comment)->ToString(SaveFormat::Text);
}
使用 C++ 修改 Word 文檔中的註釋
要修改註釋，請使用 NodeCollection->idxget(int32t index) 方法檢索它並根據您的需要進行更改。以下是在 Word 文檔中修改批註的步驟。
- 首先，使用 Document 類加載 Word 文檔。
- 使用 Document->GetChildNodes(Aspose::Words::NodeType nodeType, bool isDeep) 方法檢索評論。
- 使用 NodeCollection->idxget(int32t index) 方法獲取所需的註釋並將結果轉換為 Comment。
- 更新評論。
- 最後，使用 Document->Save(System::String fileName) 方法保存文檔。
以下示例代碼顯示瞭如何使用 C++ 修改 Word 文檔中的註釋。
// 目錄路徑。
System::String sourceDataDir = u"SourceDirectory\\";
System::String outputDataDir = u"OutputDirectory\\";
// 加載Word文件
System::SharedPtr<Document> doc = System::MakeObject<Document>(sourceDataDir + u"SampleComments.docx");
// 檢索評論
System::SharedPtr<NodeCollection> comments = doc->GetChildNodes(NodeType::Comment, true);
// 獲取評論
System::SharedPtr<Comment> comment = System::DynamicCast<Comment>(comments->idx_get(0));
// 更新評論文本
comment->SetText(u"Updated Text");
// 保存文檔。
doc->Save(outputDataDir + u"UpdatedComment.docx");
使用 C++ 從 Word 文檔中刪除註釋
Aspose.Words for C++ API 提供了多種方式來從 Word 文檔中刪除註釋。在本節中，您將學習如何使用 C++ 刪除特定評論、作者評論和所有評論。
刪除特定評論
以下是刪除特定評論的步驟。
- 使用 Document 類加載 Word 文檔。
- 使用 Document->GetChildNodes(Aspose::Words::NodeType nodeType, bool isDeep) 方法檢索評論。
- 使用 NodeCollection->idxget(int32t index) 方法獲取要刪除的評論，並將結果轉換為 Comment。
- 使用 Comment->Remove() 方法刪除評論。
- 使用 Document->Save(System::String fileName) 方法保存文檔。
以下示例代碼顯示瞭如何使用 C++ 從 Word 文檔中刪除特定評論。
// 目錄路徑。
System::String sourceDataDir = u"D:\\Work\\Aspose\\01_SourceDirectory\\";
System::String outputDataDir = u"D:\\Work\\Aspose\\02_OutputDirectory\\";
// 加載Word文件
System::SharedPtr<Document> doc = System::MakeObject<Document>(sourceDataDir + u"SampleComments.docx");
// 檢索評論
System::SharedPtr<NodeCollection> comments = doc->GetChildNodes(NodeType::Comment, true);
// 獲取評論
System::SharedPtr<Comment> comment = System::DynamicCast<Comment>(comments->idx_get(2));
// 刪除評論
comment->Remove();
// 保存文檔。
doc->Save(outputDataDir + u"DeleteSpecificComments.docx");
按作者刪除評論
以下是作者刪除評論的步驟。
- 首先，使用 Document 類加載 Word 文檔。
- 使用 Document->GetChildNodes(Aspose::Words::NodeType nodeType, bool isDeep) 方法檢索評論。
- 循環評論。
- 在循環中，檢索評論並比較其作者。如果作者匹配，則刪除評論。
- 最後，使用 Document->Save(System::String fileName) 方法保存文檔。
以下是使用C++刪除作者評論的示例代碼。
// 目錄路徑。
System::String sourceDataDir = u"SourceDirectory\\";
System::String outputDataDir = u"OutputDirectory\\";
// 加載Word文件
System::SharedPtr<Document> doc = System::MakeObject<Document>(sourceDataDir + u"SampleComments.docx");
// 檢索評論
System::SharedPtr<NodeCollection> comments = doc->GetChildNodes(NodeType::Comment, true);
// 遍歷所有評論並刪除“Aspose”作者撰寫的評論。
for (int32_t i = comments->get_Count() - 1; i >= 0; i--)
{
System::SharedPtr<Comment> comment = System::DynamicCast<Comment>(comments->idx_get(i));
if (comment->get_Author() == u"Aspose")
{
comment->Remove();
}
}
// 保存文檔。
doc->Save(outputDataDir + u"DeleteCommentsByAuthor.docx");
刪除所有評論
您可以使用 NodeCollection->Clear() 方法一次刪除所有評論，而不是刪除單個評論。以下是從 Word 文檔中刪除所有評論的步驟。
- 使用 Document 類加載 Word 文檔。
- 使用 Document->GetChildNodes(Aspose::Words::NodeType nodeType, bool isDeep) 方法檢索註釋。
- 使用 NodeCollection->Clear() 方法刪除所有註釋。
- 最後，使用 Document->Save(System::String fileName) 方法保存文檔。
下面的示例代碼演示瞭如何使用 C++ 刪除 Word 文檔中的所有註釋。
// 目錄路徑。
System::String sourceDataDir = u"SourceDirectory\\";
System::String outputDataDir = u"OutputDirectory\\";
// 加載Word文件
System::SharedPtr<Document> doc = System::MakeObject<Document>(sourceDataDir + u"SampleComments.docx");
// 檢索評論
System::SharedPtr<NodeCollection> comments = doc->GetChildNodes(NodeType::Comment, true);
// 刪除所有評論。
comments->Clear();
// 保存文檔。
doc->Save(outputDataDir + u"DeleteAllComments.docx");
獲得免費許可證
您可以通過申請 免費的臨時許可證 來試用沒有評估限制的 API。
結論
在本文中，您了解瞭如何使用 C++ 在 Word 文檔中處理註釋。具體來說，您已經學習瞭如何添加、閱讀、編輯和刪除評論。此外，您還了解瞭如何使用 Aspose.Words for C++ API 刪除特定評論、作者評論以及所有評論。 API 提供了大量附加功能，用於自動執行與 Word 相關的任務。您可以通過訪問 官方文檔 來詳細探索 API。如有任何疑問，請隨時通過我們的免費支持論壇與我們聯繫。