WarningType

WarningType enumeration

指定在文档加载或保存期间由 Aspose.Words 发出的警告类型。

[Flags]
public enum WarningType

价值观

姓名价值描述
DataLossCategoryFF加载后文档树中或保存后创建的文档中将会缺少某些文本/字符/图像或其他数据。
DataLoss1一般数据丢失，没有特定代码。
MajorFormattingLossCategoryFF00生成的文档或其中的特定位置可能与原始文档有很大不同。
MajorFormattingLoss100通用主要格式丢失，没有特定代码。
MinorFormattingLossCategoryFF0000与原始文档相比，生成的文档或其中的特定位置可能看起来略有不同。
MinorFormattingLoss10000通用轻微格式损失，无具体代码。
FontSubstitution20000字体已被替换。
FontEmbedding40000保存文档时丢失嵌入的字体信息。
UnexpectedContentCategoryF000000源文档中的某些内容无法识别（即不受支持），这可能会或可能不会 导致问题或造成数据/格式丢失。
UnexpectedContent1000000一般意外内容，没有特定代码。
Hint10000000指出潜在问题或提出改进建议。

例子

展示如何设置属性以从可用的字体源中查找与缺失字体最接近的匹配项。

public void EnableFontSubstitution()
{
    // 打开包含使用我们任何字体源中都不存在的字体格式化的文本的文档。
    Document doc = new Document(MyDir + "Missing font.docx");

    // 分配一个回调来处理字体替换警告。
    HandleDocumentSubstitutionWarnings substitutionWarningHandler = new HandleDocumentSubstitutionWarnings();
    doc.WarningCallback = substitutionWarningHandler;

    // 设置默认字体名称并启用字体替换。
    FontSettings fontSettings = new FontSettings();
    fontSettings.SubstitutionSettings.DefaultFontSubstitution.DefaultFontName = "Arial";
    ;
    fontSettings.SubstitutionSettings.FontInfoSubstitution.Enabled = true;

    // 字体替换后应使用原始字体规格。
    doc.LayoutOptions.KeepOriginalFontMetrics = true;

    // 如果我们保存缺少字体的文档，我们将收到字体替换警告。
    doc.FontSettings = fontSettings;
    doc.Save(ArtifactsDir + "FontSettings.EnableFontSubstitution.pdf");

    using (IEnumerator<WarningInfo> warnings = substitutionWarningHandler.FontWarnings.GetEnumerator())
        while (warnings.MoveNext())
            Console.WriteLine(warnings.Current.Description);

    // 我们还可以验证集合中的警告并清除它们。
    Assert.AreEqual(WarningSource.Layout, substitutionWarningHandler.FontWarnings[0].Source);
    Assert.AreEqual(
        "Font '28 Days Later' has not been found. Using 'Calibri' font instead. Reason: alternative name from document.",
        substitutionWarningHandler.FontWarnings[0].Description);

    substitutionWarningHandler.FontWarnings.Clear();

    Assert.AreEqual(0, substitutionWarningHandler.FontWarnings.Count);
}

public class HandleDocumentSubstitutionWarnings : IWarningCallback
{
    /// <summary>
    /// 每次加载/保存期间出现警告时调用。
    /// </summary>
    public void Warning(WarningInfo info)
    {
        if (info.WarningType == WarningType.FontSubstitution)
            FontWarnings.Warning(info);
    }

    public WarningInfoCollection FontWarnings = new WarningInfoCollection();
}

也可以看看

WarningSource Enum Watermark Class