如何使用C++ 在Word文檔中創建列表

列表分類是指在Word文檔中使用不同格式排序的列表,來幫助我們一目瞭然地表達出一段文字的主要內容。比如,當我們描述了某個主題的若干點,就可以用列表把它們一一表達出來,而不是寫成完整的段落形式。同時,列表也可以幫助我們做出精確的計算和比較,簡潔有效地表示出不同部分之間的關係。在Word文檔中創建列表可以便於人們去檢索資料方便定位,其中總共有四種不同類型的列表:編號列表、項目符號列表、多級編號列表和多級混合類型列表。本文就將詳細爲您介紹如何使用C++在Word文檔中創建編號列表、項目符號列表和多級列表

  • 在Word中創建編號列表
  • 在Word中創建項目符號列表
  • 在Word中創建多級編號列表
  • 在Word中創建多級混合類型列表

安裝 Spire.Doc for C++

有兩種方法可以將 Spire.Doc for C++ 集成到您的應用程序中。一種方法是通過 NuGet 安裝它,另一種方法是從我們的網站下載包並將庫複製到您的程序中。通過 NuGet 安裝更簡單,更推薦使用。您可以通過訪問以下鏈接找到更多詳細信息。

如何將 Spire.Doc for C++ 集成到 C++ 程序中

在Word中創建編號列表

您可以使用ListStyle類創建編號列表樣式或項目符號樣式。然後,可以使用Paragraph->GetListFormat()->ApplyStyle() 方法將列表樣式應用於段落。創建編號列表的步驟如下。

  • 創建一個Document對象。
  • 使用Document->AddSection() 方法添加一個節。
  • 創建ListStyle類的實例,將列表類型指定爲Numbered
  • 使用ListStyle->GetLevels()->GetItem(index) 方法獲取列表的特定級別,並使用ListLevel->SetPatternType() 方法設置編號類型。
  • 使用Document->GetListStyles()->Add() 方法將列表樣式添加到文檔中。
  • 使用Section->AddParagraph() 方法將多個段落添加到文檔中。
  • 使用Paragraph->GetListFormat()->ApplyStyle() 方法將列表樣式應用於特定段落。
  • 使用Paragraph->GetListFormat()->GetListLevelNumber() 方法指定列表級別。
  • 使用Document->SaveToFile() 方法將文檔保存到Word文件中。

完整代碼

C++

#include "Spire.Doc.o.h";

using namespace Spire::Doc;
using namespace std;

int main() {

    //創建一個Document對象
    intrusive_ptr<Document> document = new Document();

    //添加一個節
    intrusive_ptr<Section> section = document->AddSection();

    //創建編號列表樣式
    intrusive_ptr<ListStyle> listStyle = new ListStyle(document, ListType::Numbered);
    listStyle->SetName(L"numberedList");
    listStyle->GetLevels()->GetItem(0)->SetPatternType(ListPatternType::DecimalEnclosedParen);
    listStyle->GetLevels()->GetItem(0)->SetTextPosition(20);
    document->GetListStyles()->Add(listStyle);

    //添加一個段落
    intrusive_ptr<Paragraph> paragraph = section->AddParagraph();
    paragraph->AppendText(L"完整的論證要素:");
    paragraph->GetFormat()->SetAfterSpacing(5);

    //添加段落並對其應用編號列表樣式
    paragraph = section->AddParagraph();
    paragraph->AppendText(L"論題");
    paragraph->GetListFormat()->ApplyStyle(L"numberedList");
    paragraph->GetListFormat()->SetListLevelNumber(0);

    //再添加四個段落,並將編號列表樣式應用於特定段落
    paragraph = section->AddParagraph();
    paragraph->AppendText(L"論點");
    paragraph->GetListFormat()->ApplyStyle(L"numberedList");
    paragraph->GetListFormat()->SetListLevelNumber(0);

    paragraph = section->AddParagraph();
    paragraph->AppendText(L"論據");
    paragraph->GetListFormat()->ApplyStyle(L"numberedList");
    paragraph->GetListFormat()->SetListLevelNumber(0);

    paragraph = section->AddParagraph();
    paragraph->AppendText(L"論證方式");
    paragraph->GetListFormat()->ApplyStyle(L"numberedList");
    paragraph->GetListFormat()->SetListLevelNumber(0);


    //將文檔保存爲Word文件
    document->SaveToFile(L"FE編號列表.docx", FileFormat::Docx2019);
    document->Dispose();
}

效果圖

在Word中創建項目符號列表

創建項目符號列表的過程與創建編號列表的過程類似。不同之處在於,創建列表樣式時,必須將列表類型指定爲“項目符號”,併爲其設置項目符號。以下是詳細步驟。

  • 創建一個Document對象。
  • 使用Document->AddSection() 方法添加一個節。
  • 創建ListStyle類的實例,將列表類型指定爲“Bulleted”。
  • 使用ListStyle->GetLevels()->Get(index) 方法獲取列表的特定級別,並使用ListLevel->SetBulletCharacter() 方法設置項目符號。
  • 使用Document->GetListStyles()->Add() 方法將列表樣式添加到文檔中。
  • 使用Section->AddParagraph() 方法將多個段落添加到文檔中。
  • 使用Paragraph->GetListFormat()->ApplyStyle() 方法將列表樣式應用於特定段落。
  • 使用Paragraph->GetListFormat()->SetListLevelNumber() 方法指定列表級別。
  • 使用Document->SaveToFile() 方法將文檔保存到Word文件中。

完整代碼

C++

#include "Spire.Doc.o.h";

using namespace Spire::Doc;
using namespace std;

int main() {

    //創建一個Document對象
    intrusive_ptr<Document> document = new Document();

    //添加一個節
    intrusive_ptr<Section> section = document->AddSection();

    //創建項目符號列表樣式
    intrusive_ptr<ListStyle> listStyle = new ListStyle(document, ListType::Bulleted);
    listStyle->SetName(L"bulletedList");
    listStyle->GetLevels()->GetItem(0)->SetBulletCharacter(L"\u00B7");
    listStyle->GetLevels()->GetItem(0)->GetCharacterFormat()->SetFontName(L"Symbol");
    listStyle->GetLevels()->GetItem(0)->SetTextPosition(20);
    document->GetListStyles()->Add(listStyle);

    //添加一個段落
    intrusive_ptr<Paragraph> paragraph = section->AddParagraph();
    paragraph->AppendText(L"常用的六種論證方法:");
    paragraph->GetFormat()->SetAfterSpacing(5);

    //添加段落並對其應用項目符號列表樣式
    paragraph = section->AddParagraph();
    paragraph->AppendText(L"舉例論證");
    paragraph->GetListFormat()->ApplyStyle(L"bulletedList");
    paragraph->GetListFormat()->SetListLevelNumber(0);

    //再添加五個段落,並將項目符號列表樣式應用於特定段落
    paragraph = section->AddParagraph();
    paragraph->AppendText(L"道理論證");
    paragraph->GetListFormat()->ApplyStyle(L"bulletedList");
    paragraph->GetListFormat()->SetListLevelNumber(0);

    paragraph = section->AddParagraph();
    paragraph->AppendText(L"對比論證");
    paragraph->GetListFormat()->ApplyStyle(L"bulletedList");
    paragraph->GetListFormat()->SetListLevelNumber(0);

    paragraph = section->AddParagraph();
    paragraph->AppendText(L"比喻論證");
    paragraph->GetListFormat()->ApplyStyle(L"bulletedList");
    paragraph->GetListFormat()->SetListLevelNumber(0);

    paragraph = section->AddParagraph();
    paragraph->AppendText(L"引用論證");
    paragraph->GetListFormat()->ApplyStyle(L"bulletedList");
    paragraph->GetListFormat()->SetListLevelNumber(0);

    paragraph = section->AddParagraph();
    paragraph->AppendText(L"因果論證");
    paragraph->GetListFormat()->ApplyStyle(L"bulletedList");
    paragraph->GetListFormat()->SetListLevelNumber(0);

    //保存結果文檔
    document->SaveToFile(L"FE項目符號列表.docx", FileFormat::Docx2019);
    document->Dispose();
}

效果圖

在Word中創建多級編號列表

多級列表至少由兩個不同的級別組成。嵌套列表的每個級別都可以使用ListStyle->GetLevels()->GetItem(index) 方法進行訪問。通過ListLevel對象,您可以設置某個級別的編號類型和前綴。以下是在Word中創建多級編號列表的步驟。

  • 創建一個Document對象。
  • 使用Document->AddSection() 方法添加一個節。
  • 創建ListStyle類的實例,將列表類型指定爲Numbered
  • 使用ListStyle->GetLevels()->GetItem(index) 方法獲取列表的特定級別,並設置編號類型和前綴。
  • 使用Document->GetListStyles()->Add() 方法將列表樣式添加到文檔中。
  • 使用Section->AddParagraph() 方法將多個段落添加到文檔中。
  • 使用Paragraph->GetListFormat()->ApplyStyle() 方法將列表樣式應用於特定段落。
  • 使用Paragraph->GetListFormat()->SetListLevelNumber() 方法指定列表級別。
  • 使用Document->SaveToFile() 方法將文檔保存到Word文件中。

完整代碼

C++

#include "Spire.Doc.o.h";

using namespace Spire::Doc;
using namespace std;

int main() {

    //創建一個Document對象
    intrusive_ptr<Document> document = new Document();

    //添加一個節
    intrusive_ptr<Section> section = document->AddSection();

    //創建編號列表樣式,指定每個級別的編號前綴和圖案類型
    intrusive_ptr<ListStyle> listStyle = new ListStyle(document, ListType::Numbered);
    listStyle->SetName(L"nestedStyle");
    listStyle->GetLevels()->GetItem(0)->SetPatternType(ListPatternType::Arabic);
    listStyle->GetLevels()->GetItem(0)->SetTextPosition(20);
    listStyle->GetLevels()->GetItem(1)->SetNumberPrefix(L"%1.");
    listStyle->GetLevels()->GetItem(1)->SetPatternType(ListPatternType::Arabic);
    listStyle->GetLevels()->GetItem(2)->SetNumberPrefix(L"%1.%2.");
    listStyle->GetLevels()->GetItem(2)->SetPatternType(ListPatternType::Arabic);
    document->GetListStyles()->Add(listStyle);

    //添加一個段落
    intrusive_ptr<Paragraph> paragraph = section->AddParagraph();
    paragraph->AppendText(L"這是一個多級編號列表:");
    paragraph->GetFormat()->SetAfterSpacing(5);

    //添加段落並對其應用編號列表樣式
    paragraph = section->AddParagraph();
    paragraph->AppendText(L"水果");
    paragraph->GetListFormat()->ApplyStyle(L"nestedStyle");
    paragraph->GetListFormat()->SetListLevelNumber(0);

    //再添加五個段落,並將編號列表樣式應用於特定段落
    paragraph = section->AddParagraph();
    paragraph->AppendText(L"蔬菜");
    paragraph->GetListFormat()->ApplyStyle(L"nestedStyle");
    paragraph->GetListFormat()->SetListLevelNumber(0);

    paragraph = section->AddParagraph();
    paragraph->AppendText(L"根菜類");
    paragraph->GetListFormat()->ApplyStyle(L"nestedStyle");
    paragraph->GetListFormat()->SetListLevelNumber(1);

    paragraph = section->AddParagraph();
    paragraph->AppendText(L"葉菜類");
    paragraph->GetListFormat()->ContinueListNumbering();
    paragraph->GetListFormat()->ApplyStyle(L"nestedStyle");

    paragraph = section->AddParagraph();
    paragraph->AppendText(L"小白菜");
    paragraph->GetListFormat()->ApplyStyle(L"nestedStyle");
    paragraph->GetListFormat()->SetListLevelNumber(2);

    paragraph = section->AddParagraph();
    paragraph->AppendText(L"穀物");
    paragraph->GetListFormat()->ApplyStyle(L"nestedStyle");
    paragraph->GetListFormat()->SetListLevelNumber(0);

    //保存結果文檔
    document->SaveToFile(L"FE多級編號列表.docx", FileFormat::Docx2019);
    document->Dispose();
}

效果圖

在Word中創建多級混合類型列表

多級列表可以是編號列表和項目符號列表的組合。要創建混合類型列表,只需要創建編號列表樣式和項目符號列表樣式,並將它們應用於不同的段落。具體步驟如下。

  • 創建一個Document對象。
  • 使用Document->AddSection() 方法添加一個節。
  • 創建編號列表樣式和項目符號列表樣式。
  • 使用Section->AddParagraph() 方法將多個段落添加到文檔中。
  • 使用Paragraph->GgetListFormat()->ApplyStyle() 方法將不同的列表樣式應用於不同的段落。
  • 使用Document->SaveToFile() 方法將文檔保存到Word文件中。

完整代碼

C++

#include "Spire.Doc.o.h";

using namespace Spire::Doc;
using namespace std;

int main() {

    //創建一個Document對象
    intrusive_ptr<Document> document = new Document();

    //添加一個節
    intrusive_ptr<Section> section = document->AddSection();

    //創建編號列表樣式
    intrusive_ptr<ListStyle> numberedListStyle = new ListStyle(document, ListType::Numbered);
    numberedListStyle->SetName(L"numberedStyle");
    numberedListStyle->GetLevels()->GetItem(0)->SetPatternType(ListPatternType::Arabic);
    numberedListStyle->GetLevels()->GetItem(0)->SetTextPosition(20);
    numberedListStyle->GetLevels()->GetItem(1)->SetPatternType(ListPatternType::LowLetter);
    document->GetListStyles()->Add(numberedListStyle);

    //創建項目符號列表樣式
    intrusive_ptr<ListStyle> bulletedListStyle = new ListStyle(document, ListType::Bulleted);
    bulletedListStyle->SetName(L"bulletedStyle");
    bulletedListStyle->GetLevels()->GetItem(2)->SetBulletCharacter(L"\u002A");
    bulletedListStyle->GetLevels()->GetItem(2)->GetCharacterFormat()->SetFontName(L"Symbol");
    document->GetListStyles()->Add(bulletedListStyle);

    //添加段落
    intrusive_ptr<Paragraph> paragraph = section->AddParagraph();
    paragraph->AppendText(L"這是一個多級混合列表:");
    paragraph->GetFormat()->SetAfterSpacing(5);

    //添加段落並對其應用編號列表樣式
    paragraph = section->AddParagraph();
    paragraph->AppendText(L"水果");
    paragraph->GetListFormat()->ApplyStyle(L"numberedStyle");
    paragraph->GetListFormat()->SetListLevelNumber(0);

    //再添加五個段落,並對其應用不同的列表樣式
    paragraph = section->AddParagraph();
    paragraph->AppendText(L"瓜果類");
    paragraph->GetListFormat()->ApplyStyle(L"numberedStyle");
    paragraph->GetListFormat()->SetListLevelNumber(1);

    paragraph = section->AddParagraph();
    paragraph->AppendText(L"漿果類");
    paragraph->GetListFormat()->SetListLevelNumber(1);
    paragraph->GetListFormat()->ApplyStyle(L"numberedStyle");

    paragraph = section->AddParagraph();
    paragraph->AppendText(L"蔓越莓");
    paragraph->GetListFormat()->ApplyStyle(L"bulletedStyle");
    paragraph->GetListFormat()->SetListLevelNumber(2);

    paragraph = section->AddParagraph();
    paragraph->AppendText(L"覆盆子");
    paragraph->GetListFormat()->ApplyStyle(L"bulletedStyle");
    paragraph->GetListFormat()->SetListLevelNumber(2);

    paragraph = section->AddParagraph();
    paragraph->AppendText(L"蔬菜");
    paragraph->GetListFormat()->ApplyStyle(L"numberedStyle");
    paragraph->GetListFormat()->SetListLevelNumber(0);

    //保存結果文檔
    document->SaveToFile(L"FE多級混合類型列表.docx", FileFormat::Docx);
    document->Dispose();
}

效果圖

—本文完—

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章