FitImageAndRelease

Afbeeldingsverwerking, pagina-indeling, optimalisatie

Beschrijving

Past de opgegeven afbeelding binnen een doelrechthoek aan, behoudt de beeldverhouding, past de gevraagde uitlijning en rotatie toe en geeft die afbeeldingshandle daarna vrij uit de afbeeldingscache van het document

Gebruik deze helper wanneer een batchgenerator veel eenmalig gebruikte afbeeldingen toevoegt die na plaatsing niet selecteerbaar moeten blijven

Syntaxis

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

Syntaxis

ImageID	De afbeeldingshandle geretourneerd door een functie voor het aanmaken of importeren van afbeeldingen
Left	De horizontale coördinaat van de doelrechthoek
Top	De verticale coördinaat van de doelrechthoek
Width	De breedte van de doelrechthoek
Height	De hoogte van de doelrechthoek
HAlign	Horizontale uitlijning binnen de rechthoek, waarbij 0 links is, 1 gecentreerd en 2 rechts
VAlign	Verticale uitlijning binnen de rechthoek, waarbij 0 boven is, 1 gecentreerd en 2 onder
Rotate	Rotatiemodus: 0 is normaal, 1 is 90 graden tegen de klok in, 2 is 90 graden met de klok mee en 3 is 180 graden

Retourwaarden

0	De image handle was ongeldig, een plaatsingsoptie viel buiten het bereik, de afbeelding kon niet worden getekend of de handle kon niet worden vrijgegeven
1	De afbeelding is aangepast en de handle is vrijgegeven

Opmerkingen

De opgeslagen PDF behoudt het afbeeldingsobject omdat het resourcewoordenboek van de pagina er al naar verwijst voordat de cachehandle wordt vrijgegeven

Nadat deze functie is geslaagd, geeft SelectImage(ImageID) 0 terug voor die vrijgegeven handle