FitImageAndRelease

Gestione delle immagini, layout di pagina, ottimizzazione

Descrizione

Adatta l'immagine al rettangolo di destinazione, preserva le proporzioni, applica allineamento e rotazione richiesti, quindi rilascia l'handle dalla cache immagini del documento

Usare quando un generatore batch aggiunge molte immagini monouso da non lasciare selezionabili

Sintassi

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

Parametri

ImageID	L'handle immagine restituito da una funzione di creazione o importazione immagini
Left	La coordinata orizzontale del rettangolo di destinazione
Top	La coordinata verticale del rettangolo di destinazione
Width	La larghezza del rettangolo di destinazione
Height	L'altezza del rettangolo di destinazione
HAlign	Allineamento orizzontale nel rettangolo, dove 0 è a sinistra, 1 è al centro e 2 è a destra
VAlign	Allineamento verticale nel rettangolo, dove 0 è in alto, 1 è al centro e 2 è in basso
Rotate	Rotazione: 0 normale, 1 90° antiorario, 2 90° orario, 3 180°

Valori restituiti

0	L'handle immagine non era valido, un'opzione di posizionamento non rientrava nell'intervallo, non è stato possibile disegnare l'immagine oppure non è stato possibile rilasciare l'handle
1	L'immagine è stata adattata e l'handle è stato rilasciato

Note

Il PDF salvato conserva l'oggetto immagine perché il dizionario delle risorse della pagina vi fa già riferimento prima del rilascio dell'handle della cache

Dopo il successo, SelectImage(ImageID) restituisce 0 per l'handle rilasciato