{{< figure align=center src=“images/Create-Word-Document-in-C.jpg” alt=“Create Word Documents in C++">}}
Aspose.Words is a feature‑rich API collection that lets you create, edit, and convert MS Word files programmatically. It offers basic and advanced word‑processing features. This article shows how to use Aspose.Words for C++ to create MS Word documents from scratch using C++. Step‑by‑step instructions and code samples demonstrate inserting text, images, tables, lists and other elements.
- C++ Word Processing API
- Create MS Word Documents using C++
- Edit or Update Existing MS Word DOC/DOCX
- Insert Images in Word Documents using C++
- Insert Table in Word Documents using C++
- Add Lists in Word Documents using C++
C++ API to Create MS Word Documents
Aspose.Words for C++ lets you generate and manipulate Word documents in C++ applications without Microsoft Word. Download the API or install it via NuGet with this command.
PM> Install-Package Aspose.Words.Cpp
Create MS Word Documents using C++
First, create a simple Word document and save it as a .doc or .docx file. Follow these steps:
- Create a blank Word document using the Document class.
- Create a DocumentBuilder object to add content.
- Add text with the DocumentBuilder‑>Writeln() method.
- Save the file using the Document‑>Save() method.
The following code sample shows how to create a Word DOCX document using C++.
{{< gist aspose-com-gists 6d4a3300f974c38f3d5f775c35d649e5 “create-word-document.cpp” >}}
Edit or Update Existing Word DOC/DOCX using C++
You can also edit existing Word files with Aspose.Words for C++. The API uses the Document Object Model (DOM) to represent a document in memory, allowing access to headers, footers, paragraphs, tables, etc. Learn more about the DOM here.
To update a document, load it with the Document class and modify it as needed. Steps to edit an existing Word document:
- Load the document using the Document class.
- Create a DocumentBuilder object to access content.
- Locate the desired paragraph (or other element) and update it.
- Save the changes with the Document‑>Save() method.
The following code sample shows how to update a paragraph’s text in a Word document using C++.
{{< gist aspose-com-gists 6d4a3300f974c38f3d5f775c35d649e5 “update-word-document.cpp” >}}
Insert Images in Word Document using C++
To insert an image into a Word document, follow these steps:
- Create a new document or load an existing one with the Document class.
- Instantiate a DocumentBuilder object linked to the document.
- Use DocumentBuilder‑>InsertImage(String fileName, RelativeHorizontalPosition horzPos, double left, RelativeVerticalPosition vertPos, double top, double width, double height, WrapType wrapType) to add the image.
- Save the document.
The following code sample shows how to insert an image using C++.
{{< gist aspose-com-gists 6d4a3300f974c38f3d5f775c35d649e5 “create-word-document-image.cpp” >}}
Insert Table in Word Documents using C++
Tables organize data in rows and columns. To generate a table, follow these steps:
- Create a new document with the Document class.
- Create a Table object.
- Insert the table using
_Document->get_FirstSection()->get_Body()->AppendChild(). - Create a new row with the Row class.
- Add the row to the table via
_Table->AppendChild(row). - Create a Cell and insert text using Cell‑>get_FirstParagraph()->AppendChild() .
- Add the cell to the row with
_Row->AppendChild(). - Repeat to add more rows.
- Save the document using Document‑>Save() .
The following code sample shows how to insert a table using C++.
{{< gist aspose-com-gists 6d4a3300f974c38f3d5f775c35d649e5 “create-word-document-table.cpp” >}}
Add Lists in Word Documents using C++
To create a bullet list, follow these steps:
- Create a new document or load an existing one with the Document class.
- Define a DocumentBuilder object linked to the document.
- Create the list using
_DocumentBuilder->get_ListFormat()->set_List(Document->get_Lists()->Add(ListTemplate::NumberArabicDot)). - Populate the list and set its level.
- Save the document.
The following code sample shows how to create a list using C++.
{{< gist aspose-com-gists 6d4a3300f974c38f3d5f775c35d649e5 “create-word-document-list.cpp” >}}
Conclusion
This guide demonstrated how to create MS Word documents from scratch using C++. You also learned how to insert text, images, tables, and lists into new or existing documents. Explore more advanced API features in the documentation.