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 LongDLL
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