RenderPagesToFilesA
Рендеринг и печать
Описание
Завершающая A обозначает точку входа DLL типа ANSI (char); интерфейс ActiveX/COM предоставляет только форму Unicode. Поведение идентично RenderPagesToFiles, а строковые аргументы интерпретируются с использованием текущей кодовой страницы SetAnsiMode
Выполняет отрисовку страниц выбранного документа, заданных в PageRanges, в отдельные файлы изображений
Функция принимает те же значения параметра Options для отрисовки, что и RenderPageToFile и RenderDocumentToFile, однако PageRanges позволяет выбирать несмежные страницы, например 1,3,7-9, Odd или Even 2-20
Если FileName содержит %p, этот токен заменяется номером исходной страницы. Если FileName не содержит %p, номер исходной страницы вставляется перед расширением файла
Реализация повторно использует один рендерер для всего списка выбранных страниц там, где активный рендерер это поддерживает, что позволяет избежать накладных расходов на инициализацию при каждом вызове RenderPageToFile
Синтаксис
Delphi
Function DLRenderPagesToFilesA(InstanceID: Integer; DPI: Double; PageRanges: PAnsiChar; Options: Integer; FileName: PAnsiChar): Integer;DLL
int DLRenderPagesToFilesA(int InstanceID, double DPI, const char * PageRanges, int Options, const char * 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 | Количество страниц, успешно отрисованных до завершения или первой ошибки |