CView::DoPreparePrinting

BOOL DoPreparePrinting( CPrintInfo* pInfo );

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

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

Аргументы

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

Примечание

Данная функция вызывается из перегруженной функции OnPreparePrinting для вызова диалогового окна Печать и создания контекста устройства принтера.

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

Если функция вызывается в режиме предварительного просмотра печати, данная функция создаёт контекст устройства принтера, основываясь на его текущих установках. Контекст устройства используется для имитации принтера в процессе предварительного просмотра.

CView::GetDocument

CDocument* GetDocument( ) const;

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

Указатель на объект класса CDocument, связанный с данным классом представления или NULL, если с данным классом не связан никакой документ.

Примечание

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

CView::OnBeginPrinting

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

Аргументы

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

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

Примечание

Данная функция вызывается приложением при инициализации процесса печати или предварительного просмотра печати после вызова функции OnPreparePrinting. По умолчанию эта функция не выполняет никаких операций. Перегрузка данной функции позволяет включить в контекст устройства любые ресурсы GDI такие, как перья или шрифты, необходимые для осуществления процесса печати. Выбор объектов GDI в контекст устройства производится в функции OnPrint отдельно для каждой страницы. Если одни и те же объекты класса представления используются для вывода изображения на экран и для его печати, используйте различные идентификаторы для ресурсов GDI, используемых в каждом из этих режимов. Это позволит обновлять экран в процессе печати документа.

Функция OnBeginPrinting может использоваться, также и для инициализации величин, зависящих от параметров используемого принтера. Например, количество страниц, необходимое для печати документа может зависеть от установок, которые сделал пользователь в диалоговом окне Настройка принтера (таких, как размер страницы). В этом случае размер документа не может быть определён в функции OnPreparePrinting, в которой недоступна вся необходимая для этого информация, содержащаяся в объекте класса контекста устройства принтера, создаваемого на основании информации, полученной из диалогового окна Настройка принтера.

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