RenderDocumentToFileA

Rendering and printing

Опис

Завершальна A позначає точку входу DLL для ANSI (char); поверхня ActiveX/COM експонує лише форму Unicode. Поведінка ідентична RenderDocumentToFile, а рядкові аргументи трактуються за поточною кодовою сторінкою SetAnsiMode

Рендерить задані сторінки вибраного документа у файл зображення на диску

Типово рендеринг виконується через системну бібліотеку GDI+, яка є в Windows XP і новіших системах. Варіант 10 — вивід TIFF (G4) — доступний лише у Windows Vista, Windows Server 2008 і новіших

Рендеринг можливий і через Cairo — для цього слугують функції SetCairoFileName і SelectRenderer

Синтаксис

Delphi

Function DLRenderDocumentToFileA(InstanceID: Integer; DPI: Double; StartPage, EndPage, Options: Integer; FileName: PAnsiChar): Integer;

DLL

int DLRenderDocumentToFileA(int InstanceID, double DPI, int StartPage, int EndPage, int Options, const char * FileName);

Параметри

DPIРоздільна здатність DPI для рендерингу. Значення 72 дає той самий результат, що й Acrobat за масштабу 100%
StartPageПерша сторінка для друку
EndPageОстання сторінка для друку
Options0 = вихід у BMP 1 = вихід у JPEG 2 = вихід у WMF 3 = вихід у EMF 4 = вихід у EPS 5 = вихід у PNG 6 = вихід у GIF 7 = вихід у TIFF 8 = вихід у EMF+ 9 = вихід у HTML5 10 = вихід у G4 TIFF Шлях та ім'я файла для збереження. Кожна сторінка зберігається в окремому файлі. Якщо параметр містить "%p", цю послідовність буде замінено номером сторінки, інакше номер сторінки додається в кінець імені файла перед розширенням. Наприклад, якщо FileName дорівнює "output.jpg", а рендериться сторінка 10, зображення буде збережено у файлі "output10.jpg". Якщо FileName дорівнює "page%poutput.bmp", а рендериться сторінка 5, зображення буде збережено у файлі "page5output.bmp"
FileName

Return values

0Сторінки не вдалося відрендерити. Зазвичай причина — параметри StartPage чи EndPage поза діапазоном
1Сторінки успішно відрендерено