Visual C++. Описание стандартных классов - DoPreparePrinting

ОГЛАВЛЕНИЕ


DoPreparePrinting

BOOL DoPreparePrinting(CPrintInfo* pInfo);

Возвращаемое значение

Ненулевое, если может начаться процесс печати или предварительного просмотра печати. Нулевое, если выполнение операции было прервано.

Аргументы

  • pInfo - указатель на объект класса CPrintInfo, содержащий описание текущего задания для принтера.

Описание

Данная функция вызывается из перегруженной функции OnPreparePrinting для вызова диалогового окна Печать и создания контекста устройства принтера. Операции, выполняемые данной функцией зависят от того, был ли вызван режим печати или режим предварительного просмотра печати (определяется значением переменной m_bPreview, являющейся членом класса CPrintInfo, на объект которого указывает аргумент pInfo). Если производится распечатка файла, данная функция выводит диалоговое окно Печать, используя значения переменных объекта класса CPrintInfo, на который указывает аргумент pInfo. После закрытия диалогового окна функция DoPreparePrinting создает объект класса контекста устройства принтера, основываясь на значениях переменных аргумента pInfo, хранящих установки пользователя в диалоговом окне Печать. Этот контекст устройства используется для печати документа. Если функция вызывается в режиме предварительного просмотра печати, данная функция создает контекст устройства принтера, основываясь на его текущих установках. Контекст устройства используется для имитации принтера в процессе предварительного просмотра.