FitImageAndRelease

Képkezelés, oldalelrendezés, optimalizálás

Leírás

A megadott képet egy cél téglalapon belülre illeszti, megőrzi a kép oldalarányát, alkalmazza a kért igazítást és forgatást, majd felszabadítja a kép kezelőjét a dokumentum képgyorsítótárából

Használja ezt a segédfüggvényt, amikor egy kötegelt előállító sok egyszer használatos képet ad hozzá, amelyeknek az elhelyezés után nem szabad kijelölhetőknek maradniuk

Szintaxis

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);

Paraméterek

ImageID	Kép létrehozására vagy importálására szolgáló függvény által visszaadott képazonosító
Left	A cél téglalap vízszintes koordinátája
Top	A cél téglalap függőleges koordinátája
Width	A céltéglalap szélessége
Height	A cél téglalap magassága
HAlign	Vízszintes igazítás a téglalapon belül, ahol 0 a bal, 1 a középső, 2 pedig a jobb
VAlign	Függőleges igazítás a téglalapon belül, ahol 0 a felső, 1 a középső, 2 az alsó
Rotate	Forgatási mód: 0 normál, 1 90 fokkal az óramutató járásával ellentétes, 2 90 fokkal az óramutató járásával megegyező, 3 pedig 180 fok

Visszatérési értékek

0	A képkezelő érvénytelen volt, egy elhelyezési beállítás tartományon kívül esett, a kép nem rajzolható meg, vagy a kezelő nem szabadítható fel
1	A képet illesztette, és a kezelőt felszabadította

Megjegyzések

A mentett PDF megőrzi a képobjektumot, mert az oldal erőforrás-szótára már a gyorsítótár-kezelő felszabadítása előtt hivatkozik rá

A függvény sikeres befejezése után a SelectImage(ImageID) 0-t ad vissza ehhez a felszabadított fogantyúhoz