RenderDocumentToFileA

Rendering and printing

Описание

The trailing A denotes the ANSI (char) DLL entry point; the ActiveX/COM surface exposes only the Unicode form. Behaviour is identical to RenderDocumentToFile and string arguments are interpreted using the current SetAnsiMode code page

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

По умолчанию растеризация идёт через 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);

Параметры

DPIDPI растеризации. Значение 72 даёт тот же результат, что Acrobat при 100% масштабе
StartPageThe first page to print
EndPageThe last page to print
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Страницы растеризованы успешно