Interface IWordImageObjectCollection

Collection of Word image objects

Namespace: IronWord.Models

Assembly: IronWord.dll

Syntax

public interface IWordImageObjectCollection

Holding every image in a Word document as one indexable group in C# runs through IWordImageObjectCollection. The contract extends IList<ImageContent>, so the pictures behave like a standard list: index them, count them, add and remove entries, and iterate with foreach. Treating the group through this contract keeps document-traversal code independent of the concrete collection type while still giving full list semantics over the images.

The concrete implementor in IronWord is ImageObjectCollection, which derives from ObservableCollection<ImageContent> and is what code receives when it reaches a document's images. Because each element is an ImageContent, every entry exposes the sizing, placement, and identity members of an image; the collection itself adds the list operations. The contract also extends the serialization abstraction, so the image set round-trips with the document model. Iterate it to extract every picture, or mutate it to add and reorder images before saving.

The extract images how-to reads each picture in turn, and the add image how-to builds the set up.