描述
设置存储在该图元文件中的某些刷位图的分辨率。
C++ 语法
GpStatus WINGDIPAPI GdipSetMetafileDownLevelRasterizationLimit( GpMetafile * metafile, UINT metafileRasterizationLimitDpi ); |
PowerBASIC 语法
FUNCTION GdipSetMetafileDownLevelRasterizationLimit ( _ BYVAL metafile AS DWORD _ BYVAL MetafileRasterizationLimitDpi AS LONG _ ) AS LONG |
参数
metafile
[in]指向图元文件对象的指针。
metafileRasterizationLimitDpi
[in]非负整数值，以英寸（dpi）为单位指定分辨率。如果将此参数设置为0，则将分辨率设置为与传递给图元文件构造函数的设备上下文句柄的分辨率相匹配。如果将此参数设置为大于0但小于10的值，则分辨率保持不变。
返回值
如果函数成功，则返回Ok，它是状态枚举的一个元素。
如果函数失败，它返回状态枚举的其他元素之一。
备注
此函数的目的是防止由于纹理和渐变刷以高分辨率存储而导致图元文件变得太大。假设您基于分辨率为600 dpi的打印机的设备上下文构造了一个图元文件对象（用于记录EmfTypeEmfOnly图元文件）。还可以根据分辨率为96 dpi的Bitmap对象创建路径渐变画笔或纹理画笔。如果表示该画笔的位图以96 dpi的分辨率存储在图元文件中，则要比以600 dpi分辨率存储的空间少得多。
元文件的默认光栅化限制为96 dpi。所以如果你根本不调用这个功能，路径渐变刷和纹理刷位图以96 dpi的分辨率存储。
光栅化限制对EmfTypeEmfOnly和EmfTypeEmfPlusDual类型的图元文件有影响，但对EmfTypeEmfPlusOnly类型的图元文件没有影响。