FitImageAndRelease

Bildhantering, Sidlayout, Optimering

Beskrivning

Passar in den angivna bilden i en målrektangel, bevarar bildens proportioner, tillämpar den begärda justeringen och rotationen och släpper sedan bildhandtaget från dokumentets bildcache

Använd denna hjälpfunktion när en batchgenerator lägger till många engångsbilder som inte ska förbli valbara efter placering

Syntax

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

Returvärden

ImageID	Bildhandtaget som returneras av en bildskapande funktion eller importfunktion
Left	Den horisontella koordinaten för målrektangelns vänstra kant
Top	Den vertikala koordinaten för målrektangelns övre kant
Width	Målrektangelns bredd
Height	Målrektangelns höjd
HAlign	Horisontell justering i rektangeln, där 0 är vänster, 1 är mitten och 2 är höger
VAlign	Vertikal justering i rektangeln, där 0 är överkant, 1 är mitten och 2 är nederkant
Rotate	Rotationsläge, där 0 är normalt, 1 är 90 grader moturs, 2 är 90 grader medurs och 3 är 180 grader

Returvärden

0	Bildhandle:t var ogiltigt, ett placeringsalternativ låg utanför intervallet, bilden kunde inte ritas, eller handle:t kunde inte släppas
1	Bilden anpassades och handle:t släpptes

Se även

Den sparade PDF-filen behåller bildobjektet eftersom sidans resursordbok redan refererar till det innan cachehandtaget släpps

När denna funktion lyckas returnerar SelectImage(ImageID) 0 för det frigjorda handtaget