RenderPageToMetafileStream

渲染和打印

描述

此函数仅在 Delphi 版本中可用;它将选定文档中的页面渲染到 TStream 中作为 Windows 元文件(矢量输出),保留页面的文本和矢量内容,而不是将其栅格化为像素

所选的 Format 控制图元文件变体:mfEMF 使用经典的 GDI 增强型图元文件路径(广泛的消费者兼容性),mfEMFPlus 和 mfEMFDual 使用 GDI+ 记录路径(对透明度和抗锯齿有更好的保真度),而 mfWMF 生成传统的 16 位格式

mfEMFDual 在同一文件中同时记录 GDI 和 GDI+ 命令,以便仅支持 GDI 的旧取用端仍能读取它,代价是文件体积较大;当已知取用端支持 GDI+ 时,首选 mfEMFPlus(Office、Illustrator、现代查看器)

在内部,这是 RenderPageToStream 的一个便利包装器,它将 Format 映射为整数 Options 值,因此 DPI 仍然会乘以通过 SetRenderScale 设置的每个实例的 RenderScale

语法

Delphi

Function TPDFlib.RenderPageToMetafileStream(DPI: Double; Page: Integer; Format: TPDFlibMetafileFormat; Target: TStream): Integer;

参数

DPI渲染页面时使用的 DPI;控制图元文件框架尺寸,矢量内容本身与 DPI 无关
Page要渲染的页码
FormatmfEMF = 经典 GDI EMF;mfEMFPlus = 仅 GDI+ EMF+;mfEMFDual = GDI+ EMF+ Dual(GDI + GDI+ 记录,较大但广泛兼容);mfWMF = 传统 16 位 WMF
Target用于放置渲染后的元文件字节的流

返回值

0页面无法渲染
1页面已正确渲染,且图元文件字节已写入流中