CView::OnPreparePrinting

virtual BOOL OnPreparePrinting( CPrintInfo* pInfo );

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

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

Аргументы

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

Примечание

Вызывается приложением перед печатью или предварительным просмотром документа. По умолчанию не производит никаких действий.

Данная функция должна быть перегружена для обеспечения возможности печати или предварительного просмотром документа. В ней необходимо вызвать функцию DoPreparePrinting и передать ей аргумент pInfo. Значение, возвращаемое функцией DoPreparePrinting, является возвращаемым значением данной функции. Функция DoPreparePrinting выводит диалоговое окно Печать и создаёт контекст устройства принтера. Если при инициализации диалогового окна Печать следует указать значения параметров, отличные от значений, используемых для них по умолчанию, следует присвоить эти значения соответствующим переменным аргумента pInfo. Например, при известном числе страниц в документе следует вызвать функцию SetMaxPage, являющуюся членом класса CPrintInfo, на объект которого указывает аргумент pInfo, перед вызовом функции DoPreparePrinting. Эта величина определит значения, выводимые в текстовых полях Страницы с: и по: диалогового окна Печать.

Функция DoPreparePrinting не выводит диалоговое окно Печать в режиме предварительного просмотра печати. Чтобы не выводить диалоговое окно Печать при печати документа, проверьте, что переменная m_bPreview, являющаяся членом класса CPrintInfo, на объект которого указывает аргумент pInfo, имеет значение FALSE, присвойте ей значение TRUE перед вызовом функции DoPreparePrinting и восстановите значение FALSE после выхода из этой функции.

Если необходимо произвести инициализацию, использующую объект класса CDC, представляющий контекст устройства принтера (например, для определения размера печатаемой страницы для определения количества страниц в документе), перегрузите функцию OnBeginPrinting.

Если необходимо установит значение переменных m_nNumPreviewPages или m_strPageDesc, являющихся членами класса CPrintInfo, на объект которого указывает аргумент pInfo, сделайте это после вызова функции DoPreparePrinting. Функция DoPreparePrinting присваивает переменной m_nNumPreviewPages значение из файла инициализации и присваивает переменной m_strPageDesc её значение по умолчанию.

Пример

Ниже приведена заготовка функции OnPreparePrinting, создаваемая мастером AppWizard при установке соответствующего флажка в диалоге создания приложения. Эта заготовка может использоваться в рабочем приложении, если нет необходимости инициализировать диалоговое окно Печать.

BOOL CMyView::OnPreparePrinting( CPrintInfo *pInfo )

{

return DoPreparePrinting( pInfo );

}

CView::OnPrint

virtual void OnPrint( CDC* pDC, CPrintInfo* pInfo );

Аргументы

0. pDC — указатель на объект класса контекста устройства принтера.

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

Примечание

Вызывается приложением для печати или предварительного просмотра страницы документа. Для каждой печатаемой страницы приложение вызывает данную функцию сразу же после вызова функции OnPrepareDC. Номер печатаемой страницы определяется значением переменной m_nCurPage, являющейся членом класса CPrintInfo, на объект которого указывает аргумент pInfo. По умолчанию данная функция вызывает функцию OnDraw и передаёт ей контекст устройства принтера.

Данная функция перегружается для решения следующих задач:

• Для печати многостраничных документов. При печати документа с использованием функции OnDraw для определения фрагмент документа, который будет распечатываться на данной странице, необходимо установить начало отсчёта рабочей области. (Однако данная операция обычно производится в функции OnPrepareDC.)

• Для изменения формы отображения документа при печати (в том случае, если приложение не соответствует принципу "Что вы видите, то вы и имеете"). В данном случае вместо того, чтобы передавать контекст устройства функции OnDraw, пользователь может вызвать собственную функцию, выводящую документ на печать и использующую для обработки изображения параметры, отличные от тех, которые используются при выводе его на экран.

• Для использования при печати документа дополнительных ресурсов GDI, не используемых при выводе его на экран. Ресурсы GDI должны выбираться в контекст устройства перед началом процесса печати и освобождаться после его завершения. Эти ресурсы создаются в функции OnBeginPrinting и уничтожаться в функции OnEndPrinting.

• Для вывода колонтитулов. При этом можно использовать функцию OnDraw, ограничив ей область печати.

Переменная m_rectDraw, являющаяся членом класса CPrintInfo, на объект которого указывает аргумент pInfo, содержит размеры области печати страницы, выраженные в логических единицах. Не следует вызывать функцию OnPrepareDC при перегрузке функции OnPrint, поскольку приложение автоматически вызывает функцию OnPrepareDC перед вызовом функции OnPrint.