DrawImageAndRelease

Manipulação de imagens, Layout da página, Otimização

Descrição

Desenha a imagem especificada na página selecionada e depois libera esse handle de imagem do cache de imagens do documento depois que a referência de recurso da página é registrada

Use este auxiliar para documentos gerados que adicionam muitas imagens de uso único e não precisam selecionar o mesmo handle de imagem novamente

Sintaxe

Delphi

Function TPDFlib.DrawImageAndRelease(ImageID: Integer; Left, Top, Width, Height: Double): Integer;

ActiveX

Function PDFlib::DrawImageAndRelease(ImageID As Long, Left As Double, Top As Double, Width As Double, Height As Double) As Long

DLL

int DLDrawImageAndRelease(int InstanceID, int ImageID, double Left, double Top, double Width, double Height);

Parâmetros

ImageID	O handle de imagem retornado por uma função de criação ou importação de imagens
Left	A coordenada horizontal da borda esquerda
Top	A coordenada vertical da borda superior
Width	The drawn width
Height	The drawn height

Valores retornados

0	O handle de imagem era inválido, a imagem não pôde ser desenhada, ou o handle não pôde ser liberado
1	A imagem foi desenhada e o handle foi liberado

Observações

O PDF salvo mantém o objeto de imagem porque o dicionário de recursos da página já faz referência a ele antes que o identificador do cache seja liberado

Depois que esta função tem sucesso, SelectImage(ImageID) retorna 0 para o handle liberado