Страница 175 из 238
OnBeginPrinting
virtual void OnBeginPrinting(CDC* pDC, CPrintInfo* pInfo);
Аргументы
- pDC - указатель на объект класса контекста устройства принтера.
- pInfo - указатель на объект класса CPrintInfo, содержащий описание текущего задания для принтера.
Описание
Данная функция вызывается приложением при инициализации процесса печати или предварительного просмотра печати после вызова функции
OnPreparePrinting. По умолчанию эта функция не выполняет никаких операций. Перегрузка данной функции позволяет включить в контекст устройства любые ресурсы GDI такие, как перья или шрифты, необходимые для осуществления процесса печати. Выбор объектов GDI в контекст устройства производится в функции
OnPrint отдельно для каждой страницы. Если одни и те же объекты класса представления используются для вывода изображения на экран и для его печати, используйте различные идентификаторы для ресурсов GDI, используемых в каждом из этих режимов. Это позволит обновлять экран в процессе печати документа. Функция
OnBeginPrinting может использоваться, также и для инициализации величин, зависящих от параметров используемого принтера. Например, количество страниц, необходимое для печати документа может зависеть от установок, которые сделал пользователь в диалоговом окне Настройка принтера (таких, как размер страницы). В этом случае размер документа не может быть определен в функции
OnPreparePrinting, в которой недоступна вся необходимая для этого информация, содержащаяся в объекте класса контекста устройства принтера, создаваемого на основании информации, полученной из диалогового окна Настройка принтера. Функция
OnBeginPrinting является первой перегружаемой функцией, имеющей доступ к объекту класса
CDC, представляющего контекст устройства принтера. Поэтому размер документа может быть определен в этой функции. Если размер документа не будет определен в этой функции, в окне предварительного просмотра печати не появится полоса прокрутки.
