DrawImageAndRelease

图像处理、页面布局、优化

说明

在选定页面上绘制指定图像,然后在登记页面资源引用后从文档图像缓存中释放该图像句柄

对于添加许多一次性图像且不需要再次选择相同图像句柄的生成文档,请使用此辅助函数

语法

Delphi

Function TPDFlib.DrawImageAndRelease(ImageID: Integer; Left, Top, Width, Height: Double): Integer;

ActiveX

Function PDFlib::DrawImageAndRelease(ImageID As Long, Left As Double, Top As Double, Width As Double, Height As Double) As Long

DLL

int DLDrawImageAndRelease(int InstanceID, int ImageID, double Left, double Top, double Width, double Height);

参数

ImageID由图像创建或导入函数返回的图像句柄
Left左边缘的水平坐标
Top上边缘的垂直坐标
Width绘制后的宽度
Height绘制后的高度

返回值

0图像句柄无效、无法绘制图像,或无法释放句柄
1图像已绘制,且句柄已释放

备注

保存后的 PDF 会保留图像对象,因为在释放缓存句柄之前页面资源字典已经引用了该对象

此函数成功后,SelectImage(ImageID) 对已释放的该句柄返回 0