FitImageAndRelease

Traitement des images, disposition des pages, optimisation

Description

Ajuste l'image indiquée dans un rectangle cible, préserve ses proportions, applique alignement et rotation puis libère son handle du cache d'images du document

Utilisez cet assistant lorsqu'un générateur par lot ajoute de nombreuses images à usage unique qui ne doivent pas rester sélectionnables après leur placement

Syntaxe

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ètres

ImageID	Descripteur d’image renvoyé par une fonction de création ou d’importation d’image
Left	Coordonnée horizontale du rectangle cible
Top	Coordonnée verticale du rectangle cible
Width	Largeur du rectangle cible
Height	Hauteur du rectangle cible
HAlign	Alignement horizontal dans le rectangle, où 0 correspond à gauche, 1 au centre et 2 à droite
VAlign	Alignement vertical dans le rectangle, où 0 correspond au haut, 1 au centre et 2 au bas
Rotate	Mode de rotation, où 0 est normal, 1 correspond à 90 degrés antihoraire, 2 à 90 degrés horaire et 3 à 180 degrés

Valeurs de retour

0	Le handle d'image n'était pas valide, une option de placement était hors plage, l'image n'a pas pu être dessinée ou le handle n'a pas pu être libéré
1	L’image a été ajustée et le descripteur a été libéré

Remarques

Le PDF enregistré conserve l’objet image, car le dictionnaire de ressources de la page le référence déjà avant la libération du handle de cache

Après la réussite de cette fonction, SelectImage(ImageID) renvoie 0 pour ce handle libéré