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 を返します