DrawImageAndRelease

Обработка изображений, макет страницы, оптимизация

Описание

Рисует указанное изображение на выбранной странице, а после регистрации ссылки на ресурс страницы освобождает дескриптор изображения из кэша изображений документа

Помощник для сгенерированных документов, добавляющих много одноразовых изображений, когда тот же дескриптор выбирать снова не нужно

Синтаксис

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

Параметры

ImageIDДескриптор изображения, возвращаемый функцией создания или импорта изображения
LeftГоризонтальная координата левого края
TopВертикальная координата верхнего края
WidthThe drawn width
HeightThe drawn height

Возвращаемые значения

0Дескриптор изображения недопустим, изображение не нарисовалось либо дескриптор не освободился
1Изображение нарисовано, дескриптор освобождён

Примечания

Сохранённый PDF сохраняет объект изображения, поскольку словарь ресурсов страницы уже ссылается на него до освобождения дескриптора кэша

После успешного вызова SelectImage(ImageID) возвращает 0 для этого освобожденного дескриптора