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 | Вертикальная координата верхнего края |
| Width | The drawn width |
| Height | The drawn height |
Возвращаемые значения
| 0 | Дескриптор изображения недопустим, изображение не нарисовалось либо дескриптор не освободился |
|---|---|
| 1 | Изображение нарисовано, дескриптор освобождён |
Примечания
Сохранённый PDF сохраняет объект изображения, поскольку словарь ресурсов страницы уже ссылается на него до освобождения дескриптора кэша
После успешного вызова SelectImage(ImageID) возвращает 0 для этого освобожденного дескриптора