FitImageAndRelease

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

说明

将指定图像适配到目标矩形内,保留图像纵横比,应用请求的对齐和旋转,然后从文档图像缓存释放该图像句柄

当批处理生成器添加许多在放置后不应保持可选状态的一次性图像时,请使用此辅助函数

语法

Delphi

Function TPDFlib.FitImageAndRelease(ImageID: Integer; Left, Top, Width, Height: Double; HAlign, VAlign, Rotate: Integer): Integer;

ActiveX

Function PDFlib::FitImageAndRelease(ImageID As Long, Left As Double, Top As Double, Width As Double, Height As Double, HAlign As Long, VAlign As Long, Rotate As Long) As Long

DLL

int DLFitImageAndRelease(int InstanceID, int ImageID, double Left, double Top, double Width, double Height, int HAlign, int VAlign, int Rotate);

参数

ImageID由图像创建或导入函数返回的图像句柄
Left目标矩形的水平坐标
Top目标矩形的垂直坐标
Width目标矩形宽度
Height目标矩形高度
HAlign矩形内的水平对齐方式,其中 0 为左对齐、1 为居中、2 为右对齐
VAlign矩形内的垂直对齐,其中 0 为顶部,1 为居中,2 为底部
Rotate旋转模式,其中 0 为正常,1 为逆时针 90 度,2 为顺时针 90 度,3 为 180 度

返回值

0图像句柄无效、放置选项超出范围、无法绘制图像,或无法释放句柄
1图像已适配并释放句柄

备注

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

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