|
Страница 26 из 40
virtual void OnPrepareDC(CDC* pDC, CPrintInfo* pInfo = NULL); Аргументы "sectiontableheader"pDC - указатель на объект класса контекста устройства, используемого для отображения документа.
"sectiontableheader"pInfo - указатель на объект структуры CPrintInfo, описывающей текущее задание печати, если функция OnPrepareDC используется для печати или предварительного просмотра печати документа. Переменная m_nCurPage данной структуры содержит номер печатаемой страницы документа. Если функция OnPrepareDC вызывается для вывода на экран, данный аргумент имеет нулевое значение.
Описание Вызывается приложением перед вызовом функции OnDraw при выводе на экран или перед функцией OnPrint перед печатью каждой станицы документа или ее предварительным просмотром. По умолчанию данная функция не выполняет никаких действий при выводе изображения на экран. Однако, данная функция может быть перегружена в производных классах, таких как CScrollView, для настройки атрибутов контекста устройства. Поэтому при ее перегрузке в пользовательских классах следует вызывать метод базового класса перед выполнением пользовательских операторов. Если данная функция вызывается для печати документа, то по умолчанию она проверяет содержимое объекта структуры, на который указывает аргумент pInfo. Если размер документа в данном объекте структуры не задан, функция OnPrepareDC считает, что документ содержит всего одну страницу и останавливает процесс печати после распечатки первой страницы документа. Для остановки процесса печати данная функция присваивает переменной m_bContinuePrinting, являющейся членом структуры CPrintInfo, значение FALSE. Обычно функция OnPrepareDC перегружается чтобы: "sectiontableheader"установить атрибуты контекста устройства для указанной страницы при ее печати. Например, в данной функции может быть установлен режим отображения;
"sectiontableheader"осуществить разбивку документа на страницы в процессе печати. Обычно, размер документа определяется при инициализации процесса его печати в функции OnPreparePrinting. Однако, в том случае, когда размер документа не может быть определен заранее (например, при печати неизвестного заранее числа записей базы данных), перегрузка функции OnPrepareDC позволяет проверять признак конца документа в процессе его печати. При достижении последней страницы документа данная функция присваивает переменной m_bContinuePrinting, являющейся членом структуры CPrintInfo, значение FALSE;
"sectiontableheader"посылать принтеру управляющие последовательности для его настройки на печать каждой страницы. Для посылки принтеру управляющих последовательностей вызовите функцию CDC::Escape для объект класса, на который указывает аргумент pDC.
При перегрузке данной функции первым ее оператором должен быть вызов метода базового класса. virtual BOOL OnPreparePrinting(CPrintInfo* pInfo); Возвращаемое значение Ненулевое для начала печати, и нулевое, если процесс печати был прерван. Аргументы "sectiontableheader"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 ее значение по умолчанию. virtual void OnPrint(CDC* pDC, CPrintInfo* pInfo); Аргументы "sectiontableheader"pDC - указатель на объект класса контекста устройства принтера.
"sectiontableheader"pInfo - указатель на объект класса CPrintInfo, содержащий описание текущего задания для принтера.
Описание Вызывается приложением для печати или предварительного просмотра страницы документа. Для каждой печатаемой страницы приложение вызывает данную функцию сразу же после вызова функции OnPrepareDC. Номер печатаемой страницы определяется значением переменной m_nCurPage, являющейся членом класса CPrintInfo, на объект которого указывает аргумент pInfo. По умолчанию данная функция вызывает функцию OnDraw и передает ей контекст устройства принтера. Данная функция перегружается для решения следующих задач: "sectiontableheader"для печати многостраничных документов. При печати документа с использованием функции OnDraw для определения фрагмент документа, который будет распечатываться на данной странице, необходимо установить начало отсчета рабочей области (однако данная операция обычно производится в функции OnPrepareDC);
"sectiontableheader"для изменения формы отображения документа при печати (в том случае, если приложение не соответствует принципу "Что вы видите, то вы и имеете"). В данном случае вместо того, чтобы передавать контекст устройства функции OnDraw, пользователь может вызвать собственную функцию, выводящую документ на печать и использующую для обработки изображения параметры, отличные от тех, которые используются при выводе его на экран;
"sectiontableheader"для использования при печати документа дополнительных ресурсов GDI, не используемых при выводе его на экран. Ресурсы GDI должны выбираться в контекст устройства перед началом процесса печати и освобождаться после его завершения. Эти ресурсы создаются в функции OnBeginPrinting и уничтожаться в функции OnEndPrinting;
"sectiontableheader"для вывода колонтитулов. При этом можно использовать функцию OnDraw, ограничив ей область печати.
Переменная m_rectDraw, являющаяся членом класса CPrintInfo, на объект которого указывает аргумент pInfo, содержит размеры области печати страницы, выраженные в логических единицах. Не следует вызывать функцию OnPrepareDC при перегрузке функции OnPrint, поскольку приложение автоматически вызывает функцию OnPrepareDC перед вызовом функции OnPrint. virtual void OnUpdate(CView* pSender, LPARAM lHint, CObject* pHint); Аргументы "sectiontableheader"pSender - указатель на объект класса представления или NULL, если необходимо модифицировать все классы представления.
"sectiontableheader"lHint - содержит информацию об изменениях.
"sectiontableheader"pHint - указатель на объект, хранящий информацию об изменениях.
Описание Данная функция является функцией обработки сообщения, посылаемого функцией CDocument::UpdateAllViews. Функция UpdateAllViews вызывается классом представления после внесения изменений в связанный с ним документ. Функция OnUpdate вызывается, также, функцией CView::OnInitialUpdate. По умолчанию функция OnUpdate посылает сообщение о необходимости перерисовки всей рабочей области окна, которая будет произведена после получения очередного сообщения WM_PAINT. Для того чтобы перерисовывалась не вся рабочая область окна, а только ее часть, необходимо перегрузить данную функцию в пользовательском классе представления. Информация об области перерисовки должна передаваться во втором или третьем параметре данной функции. Параметр lHint данной функции обычно используется для передачи битовой маски или переменной перечислимого типа. Параметр pHint является указателем на объект класса CObject, который может содержать достаточно сложные структуры данных. Для определения типа передаваемого объекта в перегруженной функции OnUpdate, обычно, используется функция CObject::IsKindOf. Как правило, функция OnUpdate не содержит вызовов функций отображения графической информации. Вместо этого она определяет прямоугольник, заданный в экранной системе координат, определяющий область экрана, нуждающуюся в обновлении, и передает указатель на него в качестве первого аргумента функции CWnd::InvalidateRec. Содержимое указанной области будет обновлено после получения очередного сообщения WM_PAINT. Если аргумент lHint имеет значение 0, а аргумент pHint - NULL, то документ посылает стандартное сообщение о необходимости перерисовки рабочей области данного класса представления. После получения стандартного сообщения о необходимости перерисовки рабочей области или в том случае, когда класс представления не смог определить, какую информацию ему передали в параметрах сообщения, он производит обновление всей своей рабочей области. |