Глава 9. Приложение с многодокументным интерфейсом (использование AppWizard)

Ресурсы приложения
Классы приложения

Главный класс приложения
Класс главного окна приложения
Класс дочернего окна MDI
Класс документа
Класс окна просмотра документа

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

Пусть при помощи AppWizard создан проект приложения multi с многооконным интерфейсом (без использования технологии OLE, сетевых технологий, баз данных). После построения проекта и запуска приложения на экране появиться главное окно. Внутри главного окна расположены меню, панель управления и панель состояния.

Сразу после запуска приложения открывается дочернее окно, предназначенное для просмотра документа, которое получает название Multi1. При помощи строк New и Open меню File можно создавать новые дочерние окна. Если одновременно открыто несколько окон, то можно упорядочить расположение этих окон и пиктограмм, представляющих минимизированные окна. Для этого предназначено меню Window.

Опишем основные файлы проекта multi (см. Приложение 3 ):

MainFrm.cpp - содержит определение методов класса CMainFrame.

MainFrm.h - содержит описание класса главного окна приложения, который называется CMainFrame. Класс CMainFrame наследуется от базового класса CMDIFrameWnd, определенного в библиотеке классов MFC.

ChildFrm.cpp - в этом файле находится реализация методов класса CChildFrame дочернего окна MDI. Класс CChildFrame наследуется от базового класса CMDIChildWnd, определенного в библиотеке классов MFC.

ChildFrm.h - содержит определение методов класса CCh ildFrame.

multi.cpp - основной файл приложения. В нем определены методы основного класса приложения CMultiApp.

multi.h - в этом файле описан главный класс приложения CMultiApp.

multiDoc.cpp - включает определение методов класса CMultiDoc.

multiDoc.h - содержит описание класса документов приложения - CMultiDoc.

multiView.cpp - содержит определение методов класса CMultiView.

multiView.h - содержит описание класса окна просмотра приложения - CMultiView.

resource.rc - файл ресурсов. В этом файле описаны все ресурсы прилржения. Сами ресурсы могут быть записаны в каталоге RES, расположенные в главном каталоге проекта.

resource.h - содержит определения идентификаторов ресурсов приложения, например, идентификаторы строк меню.

resmulti.ico - пиктограмма приложения.

resmulti.rc2 - в этом файле определены ресурсы, которые нельзя редактировать с помощью редактора ресурсов среды Visual C++.

resmultidoc.ico - пиктограмма для документов приложения.

restoolbar.bmp - файл содержит изображение кнопок панели управления tool bar.

stdafx.h, stdafx.cpp - использование этих файлов позволяет ускорить процесс повторного построения проекта.

readme.txt - текстовый файл, содержащий описание проекта. В нем кратко рассмотрен каждый файл, входящий в проект, перечислены классы приложения, а также представлена другая информация.

Ресурсы приложения

Если сравнивать ресурсы приложения multi с ресурсами приложения с однооконным интерфейсом, то видно, что в состав приложения multi входит больше ресурсов. Так, для многооконного приложения определены два меню, две пиктограммы, больше размер таблицы текстовых строк.

Шаблон меню. Для многооконного приложения multi в ресурсах проекта определены два метода с идентификаторами IDR_MAINFRAME и IDR_MULTITYPE. Приложение использует одно из этих меню в зависимости от того, открыт документ или нет.

Меню с идентификатором IDR_MAINFRAME используется, если в приложении не открыт ни один документ. Как видно из описания шаблона этого меню, его строки отличаются от строк меню однооконного приложения single.

Меню, имеющее идентификатор IDR_MULTITYPE, отображается, когда пользователь создает новый документ или открывает документ, уже записанный в файле на диске.

В этом меню определенно выпадающее меню Window, строки которого служат для управления MDI-окнами приложения:

Пиктограмма. В файле ресурсов приложения multi определены две пиктограммы IDR_MAINFRAME и IDR_MULTITYPE. Каждая из этих пиктограмм содержит по два изображения размером 32х32 и 16х16 пикселов.

Пиктограмма IDR_MAINFRAME представляет приложение, когда оно минимизировано, Эта же пиктограмма отображается в верхнем левом углу окна приложения.

Пиктограмма IDR_MULTITYPE используется для представления документа, с которым работает приложение. В отличие от приложения с однооконным интерфейсом, которое не использует эту пиктограмму, приложение с многооконным интерфейсом отображает пиктограмму IDR_MULTITYPE в верхнем левом углу окна документа.

Панель управления toolbar. Несмотря на то что приложение имеет два меню, для него определена только одна панель управления.

Идентификаторы первых трех и последних двух кнопок этой панели соответствуют идентификаторам строк и меню IDR_MAINFRAME и меню IDR_MULTITYPE. А вот вторые три идентификатора имеют соответствие только в меню IDR_MULTITYPE. Пока ни один документ не открыт и отображается IDR_MAINFRAME, эти кнопки недоступны и отображается серым цветом.

Образ кнопок панели управления расположен в файле toolbar.bmp, записанном в подкаталоге res каталога проекта.

Таблица акселераторов. Таблица акселераторов IDR_MAINFRAME приложения полностью соответствует таблице акселераторов, добавляемой MFC AppWizard к ресурсам приложения с однооконным интерфейсом.

Диалоговая панель. В ресурсах приложения определена диалоговая панель с идентификатором IDD_ABOUTBOX. Она содержит краткую информацию о приложении и отображается на экране, когда пользователь выбирает из меню Help строку Abot.

Таблица текстовых строк. Ресурсы приложения содержат несколько блоков, описывающих таблицы текстовых строк. Эти таблицы практически совпадают с таблицами приложения с однооконным приложением.

Блок текстовых строк, описывающие тип документов приложения и основные характеристики главного окна приложения, и блок текстовых строк, которые используются в панели состояния statusbar, аналогичны для такого же блока из приложения single.

В блоке текстовых строк, описывающих элементы меню, добавлен ряд текстовых строк, которые относятся к меню Window. Для однооконного приложения эти строки не определены, так как меню Window есть только у многооконных приложений.

По сравнению с ресурсами однооконного приложения для приложений с многооконным пользовательским интерфейсом добавлен еще один блок текстовых строк. В нем содержатся строки, имеющие отношение к многооконному приложению:

Классы приложения

MFC AppWizard создает для приложения с многооконным приложением несколько основных классов:

Класс приложения	Базовый класс	Описание
CMultiApp	CWinApp	Главный класс приложения
CMainFrame	CMDIFrameWnd	Класс главного окна приложения
CChildFrame	CMDIChildWnd	Класс дочернего окна MDI
CMultiDoc	CDocument	Класс документа приложения
CMultiVeiw	CView	Класс окна просмотра документа

Кроме этих основных классов создается также класс CAboutDlg, наследованный от базового CDialog. Он отвечает за диалоговую панель About. Если во время определения характеристик приложения включить возможность работы с базами данных, работу с сетевыми протоколами или использование технологии OLE, список классов приложения может стать значительно шире.

Главный класс приложения

Главный класс приложения CMultiApp управляет работой всего приложения. Методы этого класса выполняют инициализацию приложения, обработку цикла сообщений и вызываются при завершении приложения.

В приложении определен только один объект главного класса приложения -theApp. Этот объект должен быть один вне зависимости от того, какой интерфейс имеет приложение - однооконный, многооконный или основанный на диалоговой панели.

Конструктор класса. Конструктор класса, созданный MFC AppWizard, не выполняет никаких действий. В нем можно разместить код для инициализации объекта CMultiApp:

Метод InitInstance. Основную часть работы по инициализации приложения выполняет метод InitInstance главного класса приложения. Этот метод отличается от метода InitInstance, который используется (переопределяется) для однооконных приложений.

После вызова метода Enable3dControls , который позволяет использовать в приложении трехмерные элементы управления, вызывается метод LoadStdProfileSettings . Этот метод загружает файл конфигурации приложения, имеющий расширение .ini.

Затем начинается создание шаблона документа. Сначала создается указатель на объект соответствующего класса. Для однооконных приложений это класс CSingleDocTemplate , а для многооконных - CMultiDocTemplate . Новый объект класса создается при помощи оператора new.

Конструктору класса CMultiDocTemplate передается 4 параметра. Первый параметр - nIDResource - определяет идентификатор ресурсов, используемых совместно с типом документов, управляемых шаблоном. К таким ресурсам относятся меню, пиктограмма, строковый ресурс, таблица акселераторов. Для многооконного приложения в этом параметре указан идентификатор IDR_MULTITYPE.

Остальные три параметра - pDocClass, pFrameClass, pViewClass - содержат указатели на объекты класса CRuntimeClass, полученные с помощью макрокоманд RUNTIME_CLASS из классов документа CMultiDoc, дочернего окна MDI CChildFrame и окна просмотра CMultiView. Таким образом, шаблон документа объединяет всю информацию, относящуюся к данному типу документов.

Созданный шаблон документов заносится в список шаблонов, с которыми работает приложение. Для этого указатель на созданный шаблон документа передается методу AddDocTemplate из класса CWinApp .

Если разрабатывается приложение, основанное на однооконном или многооконном интерфейсе, то объект главного класса приложения управляет одним или несколькими объектами класса шаблона документа. Они, в свою очередь, управляют созданием документов. Один шаблон используется для всех документов данного типа.

После создания шаблона документа создается главное окно MDI (главное окно приложения). Для создания главного окна приложения формируется объект класса CMainFrame и записывается указатель на него в pMainFrame. Класс CMainFrame определен в приложении и будет рассматриваться ниже.

Затем для только что созданного объекта вызывается метод LoadFrame класса CFrameWnd. Он создает окно, загружает ресурсы, указанные параметром, и связывает их с объектом класса CMainFrame. Параметр метода LoadFrame определяет меню, пиктограмму, таблицу акселераторов и таблицу строк главного окна приложения.

Указатель на главное окно приложения, которым является главное окно MDI, записывается в элемент данных m_pMainWnd главного окна приложения. Этот элемент данных определен в классе CWinThread . Когда окно, представленное указателем m_pMainWnd, закрывается , приложение будет автоматически завершено.

Метод LoadFrame не отображает главного окна приложения на экране. Для этого нужно вызвать методы ShowWindow и UpdateWindow.

И, наконец, можно проверить и получить информацию из командной строки приложения. Для этого создается объект cmdInfo класса CCommandLineInfo . Этот объект передается методу ParseCommandLine класса CWinApp. Он заполняет объект cmdInfo данными, взятыми из командной строки приложения.

Подготовленный объект передается методу ProccessShellCommand класса CWinApp для обработки. После успешной обработки командной строки этот метод возвращает ненулевое значение.

После успешной инициализации приложения и обработки командной строки метод InitInstance возвращает TRUE. Начинается обработка цикла сообщений.

Таблица сообщений. Класс CMultiApp может получать сообщения и имеет таблицу сообщений. Таблица сообщений класса CMultiApp расположена в файле multi.cpp. Она содержит четыре макрокоманды для обработки командных сообщений от меню приложения.

Класс главного окна приложения

Внутри главного окна приложения отображаются панели управления и состояния, дочерние MDI-окна, используемые для просмотра документов. Для управления главным окном приложения используется класс CMainFrame, определенный в файле MainFrm.h.

Класс главного окна CMainFrame многооконного приложения практически полностью соответствует классу главного окна однооконного приложения. Однако следует обратить внимание, что класс CMainFrame наследуется от базового класса CMDIFrameWnd, а не от CFrameWnd, как это было для однооконного приложения.

Конструктор и деструктор класса. Изначально конструктор и деструктор класса CMainFrame не содержат программного кода и представляют собой простые заготовки. Их можно использовать для дополнительной инициализации объекта.

Таблица сообщений класса . Таблица сообщений класса CMainFrame содержит только одну макрокоманду ON_WM_CREATE, которая устанавливает для обработки сообщения WM_CREATE метод OnCreate . Сообщение WM_CREATE приходит во время создания главного окна приложения.

Метод OnCreate . Основное назначение метода OnCreate заключается в том, что он сначала вызывает метод OnCreate базового класса CMDIFrameWnd , а затем создает и отображает внутри главного окна панель управления toolbar и панель состояния status bar. Этот процесс происходит так же, как и для однооконного приложения.

Метод PreCreateWindow. Виртуальный метод PreCreateWindow определен в классе CWnd. Он вызывается непосредственно перед созданием окна, связанного с объектом класса.

Методы AssertValid и Dump. В отладочной версии приложения класс CMainFrame содержит переопределения виртуальных методов AssertValid и Dump. Эти методы определены в базовом классе CObject и используются при отладке приложения.

Класс дочернего окна MDI

Многооконное приложение строится с использованием большего числа классов, чем однооконное приложение. Помимо классов главного окна и классов окон просмотра документов в нем определен еще один класс, непосредствено связанный с отображением дочерних окон MDI . Этот класс называется CChildFrame, и он наследуется от базового класса CMDIChildWnd , определенного в библиотеке MFC.

Объекты класса CChildFrame представляют дочерние окна MDI главного окна приложения. Внутри этих окон отображаются окна просмотра документов.

Чаще всего приложения не вносят изменений в класс дочернего MDI-окна.

Конструктор и деструктор класса . MFC AppWizard определяет для класса CChildFrame конструктор и деструктор. По умолчанию они не выполняют никаких действий. Их можно изменить для выполнения инициализации объектов класса дочернего окна.

Таблица сообщений класса . По умолчанию таблица сообщений не содержит обработчиков сообщений. При необходимости можно добавить обработку каких-либо сообщений с использованием ClassWizard.

Метод PreCreateWin dow. Метод PreCreateWindow определен в классе CWnd. Он вызывается непосредственно перед созданием окна, связанного с объектом класса. В качестве параметра этому методу передается структура типа CREATESTRUCT, определяющая характеристики создаваемого окна. Приложение может изменить данные, записанные в этой структуре, чтобы переопределить стили создаваемого окна и повлиять на внешний вид создаваемого окна.

MFC AppWizard переопределяет этот метод, но не вносит в него в изменений и просто вызывает метод PreCreateWindow базового класса CMDIChildWnd .

Методы AssertValid и Dump. Для отладочной версии приложения класс CChildFrame содержит переопределения виртуальных методов AssertValid и Dump. Эти методы определены в базовом классе CObject и используются при отладке приложения.

Класс документа

Класс документа приложения CMultiDoc наследуется от базового класса CDocument библиотеки MFC. MFC AppWizard определяет класс документа приложения одинаково для однооконных и многооконных приложений.

Если просмотреть исходные тексты приложения, то нигде нельзя обнаружить кода, который бы явно создавал объекты этого класса. Объект класса CMultiDoc создается динамически шаблоном документа во время работы приложения. Шаблон документа также динамически создает еще два объекта - класса дочернего MDI-окна и класса окна просмотра.

Конструктор и деструктор класса. Конструктор и деструктор, подготовленные MFC AppWizard, содержат пустые блоки. Можно поместить в них код инициализации для объектов класса.

Следует иметь в виду, что для приложений, построенных на основе многооконного интерфейса, объект класса документ создается каждый раз, когда пользователь создает новый документ или открывает документ.

Таблица сообщений класса. Непосредственно после создания проекта таблица сообщений класса CMultiDoc не содержит обработчиков сообщений. Когда приложение будет разрабатываться дальше, программист может добавлять обработчики различных сообщений к классу CMultiDoc и другим классам приложения.

Методы OnNewDocument и Serialize. В классе CMultiDoc переопределены два виртуальных метода: OnNewDocument и Serialize. Эти методы аналогичны соответвующим методам класса документа однооконного приложения.

Методы AssertValid и Dump. Класс CMultiDoc содержит переопределения еще двух виртуальных методов: AssertValid и Dump, входящих в базовый класс CObject.

Класс окна просмотра документа

Следующим классом приложения multi является класс окна просмотра документа CMultiView. Этот класс наследуется от базового класса CView библиотеки MFC.

Окно просмотра и связанный с ним класс окна просмотра документа создается шаблоном документа в процессе работы приложения. Поэтому необходимо, чтобы объекты класса CMultiView можно было создавать динамически.

Для этого определяется конструктор класса, не имеющий параметров, а в определении класса указывается макрокоманда DECLARE_DYNCREATE, а в файле реализации - макрокоманда IMPLEMENT_DYNCREATE.

Класс CMultiView наследуется от базового класса CView. Однако, при необходимости, можно наследовать этот класс и от некоторых других классов библиотеки MFC.

Метод GetDocument. Этот метод возвращает указатель на документ, связанный с данным окном просмотра. Если окно просмотра не связано ни с каким документом, метод возвращает значение NULL.

Таблица сообщений класса CMultiView. Непосредственно перед таблицей сообщений класса CMultiView находится макрокоманда INPLEMENT_DYNCREATE. В таблице указываются обработчики сообщений от пунктов меню для печати ID_FILE_PRINT, ID_FILE_PRINT_DIRECT и ID_FILE_PRINT_PREVIEW.

Конструктор и деструктор класса CMultiView. Конструктор класса CMultiView, созданный MFC AppWizard, не содержит команд. Можно доработать его, чтобы конструктор выполнял инициализацию, связанную с окном просмотра.

Вместе с конструктором класса CMultiView MFC AppWizard определяет деструктор ~CMultiView. Сразу после создания проекта деструктор не выполняет никаких действий. В дальнейшем можно использовать его совместно с конструктором CMultiView.

Метод OnDraw. Это метод вызывается, когда надо отобразить документ в окне. В качестве параметра pDC методу OnDraw передается указатель на контекст устройства, используя который надо отобразить документ.

Методы OnPrepare, OnBeginPrinting и OnEndPrinting. Виртуальные методы OnPrepare, OnBeginPrinting и OnEndPrinting, определенные в классе CView, вызываются, если пользователь желает распечатать документ , отображенный в данном окне просмотра.

Методы AssertValid и Dump. На время отладки приложения в состав класса CMultiView включаются переопределения виртуальных методов AssertValid и Dump. Эти методы определены в базовом классе CObject и используются при отладке приложения. При окончательном построении приложения эти методы не переопределяются.