RenderPagesToFiles
Отрисовка и печать
Описание
Выполняет отрисовку страниц выбранного документа, заданных в PageRanges, в отдельные файлы изображений
Функция принимает те же значения параметра Options для отрисовки, что и RenderPageToFile и RenderDocumentToFile, однако PageRanges позволяет выбирать несмежные страницы, например 1,3,7-9, Odd или Even 2-20
Если FileName содержит %p, этот токен заменяется номером исходной страницы. Если FileName не содержит %p, номер исходной страницы вставляется перед расширением файла
Реализация повторно использует один рендерер для всего списка выбранных страниц там, где активный рендерер это поддерживает, что позволяет избежать накладных расходов на инициализацию при каждом вызове RenderPageToFile
Синтаксис
Delphi
Function TPDFlib.RenderPagesToFiles(DPI: Double; Const PageRanges: WideString; Options: Integer; Const FileName: WideString): Integer;
ActiveX
Function PDFlib::RenderPagesToFiles(DPI As Double, PageRanges As String, Options As Long, FileName As String) As Long
DLL
int DLRenderPagesToFiles(int InstanceID, double DPI, const wchar_t * PageRanges, int Options, const wchar_t * FileName);
Параметры
| DPI | Разрешение в DPI, используемое при отрисовке каждой страницы |
|---|---|
| PageRanges | Список диапазонов страниц, разделённых запятыми. Используйте пустую строку для отрисовки всех страниц |
| Options | 0 = вывод BMP; 1 = вывод JPEG; 2 = вывод WMF; 3 = вывод EMF; 4 = вывод EPS; 5 = вывод PNG; 6 = вывод GIF; 7 = вывод TIFF; 8 = вывод EMF+; 9 = вывод HTML5; 10 = вывод TIFF (G4) |
| FileName | Имя выходного файла или шаблон имени файла. Используйте %p в месте, куда должен вставляться номер исходной страницы |
Возвращаемое значение
| 0 | Ни одна страница не была отрисована |
|---|---|
| >0 | Количество страниц, успешно отрисованных до завершения или первой ошибки |