DocX version 1.0.0.2 released

Note: Code samples have been updated to work with DocX version 1.0.0.6.

Lots of people emailed me asking me to add support for Images in DocX. So I did. Version 1.0.0.2 which can be downloaded from here adds basic support for Images and Pictures.

Images and Pictures? Are they not the same thing you might ask? No they are not! You can think of a Picture as a customized view of an Image. Once you have added Images to a docx file.

You can then add multiple customized Pictures of those Images into Paragraphs. You can do all sorts of interesting customizations with these Pictures before inserting them into Paragraphs. At the moment docx supports the following Picture customizations;

Rotations and transformations

Resizing

Shaping

Time for an example using DocX; below is a file entitled Example.docx.

Figure 1.0 – Example.docx before code execution

The following code adds the Image Donkey.jpg into this file, it then creates two Pictures using this Image and inserts them into the last Paragraph.

// Create a .docx file
using (DocX document = DocX.Create(@"Example.docx"))
{
   // Add an Image to the docx file
   Novacode.Image img = document.AddImage(@"Donkey.jpg");

   // Insert an emptyParagraph into this document.
   Paragraph p = document.InsertParagraph("", false);

   #region pic1
   Picture pic1 = p.InsertPicture(img.Id, "Donkey", "Taken on Omey island");

   // Set the Picture pic1’s shape
   pic1.SetPictureShape(BasicShapes.cube);

   // Rotate the Picture pic1 clockwise by 30 degrees
   pic1.Rotation = 30;
   #endregion

   #region pic2
   // Create a Picture. A Picture is a customized view of an Image
   Picture pic2 = p.InsertPicture(img.Id, "Donkey", "Taken on Omey island");

   // Set the Picture pic2’s shape
   pic2.SetPictureShape(CalloutShapes.cloudCallout);

   // Flip the Picture pic2 horizontally
   pic2.FlipHorizontal = true;
   #endregion

   // Save the docx file
   document.Save();
}// Release this document from memory.

Figure 1.1 – Example.docx after code execution

Another interesting thing that you could do would be to apply an operation to every Picture in a document. The below snippet would rotate every Picture in a document clockwise by 30 degrees.

// Load the document that you want to manipulate
using (DocX document = DocX.Load(@"Test.docx"))
{
   // Loop through each Paragraph
   foreach (Paragraph p in document.Paragraphs)
   {
       // Loop through each Picture in this Paragraph
       foreach (Picture pi in p.Pictures)
       {
           // Rotate this picture clockwise by 30 degrees
           pi.Rotation = 30;
       }
   }

   // Save the document
   document.Save();
}// Release this document from memory

If you would like to send me feedback on DocX, or if you would like to make a suggestion for the next feature I implement, please email me at coffey.cathal@gmail.com.

happy coding,
Cathal