FitImageAndRelease

Manejo de imágenes, diseño de página, optimización

Descripción

Ajusta la imagen especificada dentro de un rectángulo de destino, conserva su relación de aspecto, aplica la alineación y rotación solicitadas y luego libera ese identificador de imagen de la caché de imágenes del documento

Use este asistente cuando un generador por lotes agregue muchas imágenes de un solo uso que no deberían permanecer seleccionables después de colocarse

Sintaxis

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

Parámetros

ImageID	El handle de imagen devuelto por una función de creación o importación de imágenes
Left	La coordenada horizontal del rectángulo de destino
Top	La coordenada vertical del rectángulo de destino
Width	El ancho del rectángulo de destino
Height	La altura del rectángulo de destino
HAlign	Alineación horizontal dentro del rectángulo, donde 0 es izquierda, 1 es centro y 2 es derecha
VAlign	Alineación vertical dentro del rectángulo, donde 0 es arriba, 1 es centro y 2 es abajo
Rotate	Modo de rotación, donde 0 es normal, 1 es 90 grados en sentido antihorario, 2 es 90 grados en sentido horario y 3 es 180 grados

Valores devueltos

0	El identificador de imagen no era válido, una opción de colocación estaba fuera de rango, no se pudo dibujar la imagen o no se pudo liberar el identificador
1	La imagen se ajustó y se liberó el identificador

Observaciones

El PDF guardado conserva el objeto de imagen porque el diccionario de recursos de la página ya hace referencia a él antes de liberar el identificador de caché

Una vez que esta función se completa correctamente, SelectImage(ImageID) devuelve 0 para ese identificador liberado