public class WarningInfoCollection extends java.lang.Object implements IWarningCallback, java.lang.Iterable
WarningInfo objects.
To learn more, visit the Programming with Documents documentation article.
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 LoadOptions.getWarningCallback() / LoadOptions.setWarningCallback(com.aspose.words.IWarningCallback) or DocumentBase.getWarningCallback() / DocumentBase.setWarningCallback(com.aspose.words.IWarningCallback) 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(getMyDir() + "Missing font.docx");
// Assign a callback for handling font substitution warnings.
WarningInfoCollection warningCollector = new WarningInfoCollection();
doc.setWarningCallback(warningCollector);
// Set a default font name and enable font substitution.
FontSettings fontSettings = new FontSettings();
fontSettings.getSubstitutionSettings().getDefaultFontSubstitution().setDefaultFontName("Arial");
fontSettings.getSubstitutionSettings().getFontInfoSubstitution().setEnabled(true);
// Original font metrics should be used after font substitution.
doc.getLayoutOptions().setKeepOriginalFontMetrics(true);
// We will get a font substitution warning if we save a document with a missing font.
doc.setFontSettings(fontSettings);
doc.save(getArtifactsDir() + "FontSettings.EnableFontSubstitution.pdf");
for (WarningInfo info : warningCollector)
{
if (info.getWarningType() == WarningType.FONT_SUBSTITUTION)
System.out.println(info.getDescription());
}
WarningInfo,
IWarningCallback| Modifier and Type | Method and Description |
|---|---|
void |
clear()
Removes all elements from the collection.
|
WarningInfo |
get(int index)
Gets an item at the specified index.
|
int |
getCount()
Gets the number of elements contained in the collection.
|
java.util.Iterator |
iterator()
Returns an iterator object that can be used to iterate over all items in the collection.
|
void |
warning(WarningInfo info)
Implements the
IWarningCallback interface. |
public int getCount()
Examples:
Shows how to get warnings about unsupported formats.
WarningInfoCollection warings = new WarningInfoCollection();
LoadOptions loadOptions = new LoadOptions();
loadOptions.setWarningCallback(warings);
Document doc = new Document(getMyDir() + "FB2 document.fb2", loadOptions);
Assert.assertEquals("The original file load format is FB2, which is not supported by Aspose.Words. The file is loaded as an XML document.", warings.get(0).getDescription());
public WarningInfo get(int index)
Examples:
Shows how to get warnings about unsupported formats.
WarningInfoCollection warings = new WarningInfoCollection();
LoadOptions loadOptions = new LoadOptions();
loadOptions.setWarningCallback(warings);
Document doc = new Document(getMyDir() + "FB2 document.fb2", loadOptions);
Assert.assertEquals("The original file load format is FB2, which is not supported by Aspose.Words. The file is loaded as an XML document.", warings.get(0).getDescription());
index - Zero-based index of the item.public java.util.Iterator iterator()
iterator in interface java.lang.Iterablepublic void clear()
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(getMyDir() + "Missing font.docx");
// Assign a callback for handling font substitution warnings.
WarningInfoCollection warningCollector = new WarningInfoCollection();
doc.setWarningCallback(warningCollector);
// Set a default font name and enable font substitution.
FontSettings fontSettings = new FontSettings();
fontSettings.getSubstitutionSettings().getDefaultFontSubstitution().setDefaultFontName("Arial");
fontSettings.getSubstitutionSettings().getFontInfoSubstitution().setEnabled(true);
// Original font metrics should be used after font substitution.
doc.getLayoutOptions().setKeepOriginalFontMetrics(true);
// We will get a font substitution warning if we save a document with a missing font.
doc.setFontSettings(fontSettings);
doc.save(getArtifactsDir() + "FontSettings.EnableFontSubstitution.pdf");
for (WarningInfo info : warningCollector)
{
if (info.getWarningType() == WarningType.FONT_SUBSTITUTION)
System.out.println(info.getDescription());
}
public void warning(WarningInfo info)
IWarningCallback interface. Adds a warning to this collection.
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(getMyDir() + "Missing font.docx");
// Assign a callback for handling font substitution warnings.
WarningInfoCollection warningCollector = new WarningInfoCollection();
doc.setWarningCallback(warningCollector);
// Set a default font name and enable font substitution.
FontSettings fontSettings = new FontSettings();
fontSettings.getSubstitutionSettings().getDefaultFontSubstitution().setDefaultFontName("Arial");
fontSettings.getSubstitutionSettings().getFontInfoSubstitution().setEnabled(true);
// Original font metrics should be used after font substitution.
doc.getLayoutOptions().setKeepOriginalFontMetrics(true);
// We will get a font substitution warning if we save a document with a missing font.
doc.setFontSettings(fontSettings);
doc.save(getArtifactsDir() + "FontSettings.EnableFontSubstitution.pdf");
for (WarningInfo info : warningCollector)
{
if (info.getWarningType() == WarningType.FONT_SUBSTITUTION)
System.out.println(info.getDescription());
}
warning in interface IWarningCallback