WarningInfoCollection

WarningInfoCollection class

Represents a typed collection of WarningInfo objects.

To learn more, visit the Programming with Documents documentation article.

public class WarningInfoCollection : IEnumerable<WarningInfo>, IWarningCallback

Constructors

Name	Description
WarningInfoCollection()	The default constructor.

Properties

Name	Description
Count { get; }	Gets the number of elements contained in the collection.
Item { get; }	Gets an item at the specified index.

Methods

Name	Description
Clear()	Removes all elements from the collection.
GetEnumerator()	Returns an enumerator object that can be used to iterate over all items in the collection.
Warning(WarningInfo)	Implements the `IWarningCallback` interface. Adds a warning to this collection.

Remarks

You can use this collection object as the simplest form of IWarningCallback implementation to gather all warnings that Aspose.Words generates during a load or save operation. Create an instance of this class and assign it to the WarningCallback or WarningCallback property.

Examples

Shows how to set the property for finding the closest match for a missing font from the available font sources.

// Open a document that contains text formatted with a font that does not exist in any of our font sources.
Document doc = new Document(MyDir + "Missing font.docx");

// Assign a callback for handling font substitution warnings.
WarningInfoCollection warningCollector = new WarningInfoCollection();
doc.WarningCallback = warningCollector;

// Set a default font name and enable font substitution.
FontSettings fontSettings = new FontSettings();
fontSettings.SubstitutionSettings.DefaultFontSubstitution.DefaultFontName = "Arial";
fontSettings.SubstitutionSettings.FontInfoSubstitution.Enabled = true;

// Original font metrics should be used after font substitution.
doc.LayoutOptions.KeepOriginalFontMetrics = true;

// We will get a font substitution warning if we save a document with a missing font.
doc.FontSettings = fontSettings;
doc.Save(ArtifactsDir + "FontSettings.EnableFontSubstitution.pdf");

foreach (WarningInfo info in warningCollector)
{
    if (info.WarningType == WarningType.FontSubstitution)
        Console.WriteLine(info.Description);
}