MetafileRenderingOptions

MetafileRenderingOptions class

允许指定其他图元文件渲染选项。

要了解更多信息,请访问处理 Windows 图元文件文档文章。

public class MetafileRenderingOptions

构造函数

姓名描述
MetafileRenderingOptions()默认构造函数。

特性

姓名描述
EmfPlusDualRenderingMode { get; set; }获取或设置一个值,确定应如何呈现 EMF+ 双图元文件。
EmulateRasterOperations { get; set; }获取或设置一个值,确定是否应模拟光栅操作。
EmulateRenderingToSizeOnPage { get; set; }获取或设置一个值,该值确定图元文件渲染是根据页面 上的大小模拟图元文件的显示,还是以其默认大小显示图元文件。
EmulateRenderingToSizeOnPageResolution { get; set; }获取或设置分辨率(以每英寸像素为单位),以模拟图元文件渲染为页面上的大小。
RenderingMode { get; set; }获取或设置一个值,确定图元文件图像应如何呈现。
UseEmfEmbeddedToWmf { get; set; }获取或设置一个值,确定如何呈现嵌入 EMF 图元文件的 WMF 图元文件。
UseGdiRasterOperationsEmulation { get; set; }获取或设置一个值,确定是否使用 GDI+ 进行光栅操作模拟。

例子

显示添加了位图渲染的回退和更改有关不支持的图元文件记录的警告类型。

public void HandleBinaryRasterWarnings()
{
    Document doc = new Document(MyDir + "WMF with image.docx");

    MetafileRenderingOptions metafileRenderingOptions = new MetafileRenderingOptions();

    // 将“EmulateRasterOperations”属性设置为“false”以在以下情况下回退到位图:
    // 它遇到一个图元文件,这将需要光栅操作才能在输出 PDF 中呈现。
    metafileRenderingOptions.EmulateRasterOperations = false;

    // 将“RenderingMode”属性设置为“VectorWithFallback”以尝试使用矢量图形渲染每个图元文件。
    metafileRenderingOptions.RenderingMode = MetafileRenderingMode.VectorWithFallback;

    // 创建一个“PdfSaveOptions”对象,我们可以将其传递给文档的“Save”方法
    // 修改该方法将文档转换为 .PDF 并应用配置的方式
    // 在我们的MetafileRenderingOptions对象中进行保存操作。
    PdfSaveOptions saveOptions = new PdfSaveOptions();
    saveOptions.MetafileRenderingOptions = metafileRenderingOptions;

    HandleDocumentWarnings callback = new HandleDocumentWarnings();
    doc.WarningCallback = callback;

    doc.Save(ArtifactsDir + "PdfSaveOptions.HandleBinaryRasterWarnings.pdf", saveOptions);

    Assert.AreEqual(1, callback.Warnings.Count);
    Assert.AreEqual("'R2_XORPEN' binary raster operation is not supported.",
        callback.Warnings[0].Description);
}

/// <summary>
/// 打印并收集保存文档时发生的与格式丢失相关的警告。
/// </summary>
public class HandleDocumentWarnings : IWarningCallback
{
    public void Warning(WarningInfo info)
    {
        if (info.WarningType == WarningType.MinorFormattingLoss)
        {
            Console.WriteLine("Unsupported operation: " + info.Description);
            Warnings.Warning(info);
        }
    }

    public WarningInfoCollection Warnings = new WarningInfoCollection();
}

也可以看看