Глава 4. Диалоговые панели (использование ClassWizard)

• Модальная диалоговая панель
• Диалоговая панель - главное окно приложения
• Немодальная диалоговая панель

Библиотека классов MFC содержит класс CDialog , специально предназначенный для управления диалоговыми панелями. Диалоговые панели бывают двух типов - модальные и немодальные.

И модальные и немодальные диалоговые панели обслуживаются одним (общим) классом CDialog , наследованным от базового класса CWnd .

Следующим этапом является создание класса для управления диалоговой панелью. Этот класс наследуется непосредственно от базового класса CDialog и генерируется средством ClassWizard пакета Microsoft Developer Studio.

Чтобы создать модальную диалоговую панель, сначала необходимо создать объект определенного в приложении класса диалоговой панели, а затем вызвать метод DoModal , определенный в классе CDialog .

Процедура создания немодальной диалоговой панели несколько другая. Для этого используется метод Create класса CDialog . Процесс создания немодальных диалоговых панелей будет рассматриваться позже. Сейчас остановимся на создании модального диалога.

Затем при помощи средства ClassWizard можно создать класс диалога (например, CDlg), производный от базового класса CDialog и организующий работу диалоговой панели (ClassWizard сохраняет определение и реализацию этого класса в файлах с расширениями *.cpp и *.h).

При помощи инструментов ClassWizard можно добавить в класс диалоговой панели заготовки методов-обработчиков оконных сообщений, сообщений от органов управления (например, нажатие на кнопки “OK”, “Cancel” и “Clear”) и др. Для обеспечения процесса обмена данными средствами ClassWizard можно связать элементы управления с переменными (например поле редактирования с идентификатором IDC_EDIT1 с переменной str класса CString ).

Файл 
dlg.h
	// dlg.h : header file
	//

	#include "resource.h"

	/////////////////////////////////////////////////////////////////////////////
	// CDlg dialog

	class CDlg : public CDialog
	{
	// Construction
	public:
		CDlg(CWnd* pParent = NULL);	// standard constructor

	// Dialog Data
		//{{AFX_DATA(CDlg)
		enum { IDD = IDD_DIALOG1};
		CString	m_Str;
		//}}AFX_DATA

	// Implementation
	protected:
		// DDX/DDV support
		virtual void DoDataExchange(CDataExchange* pDX);

		// Generated message map functions
		//{{AFX_MSG(CDlg)
		afx_msg void OnClickedClear();
		virtual void OnCancel();
		virtual void OnOK();
		virtual BOOL OnInitDialog();
		//}}AFX_MSG
		DECLARE_MESSAGE_MAP()
	};

Файл dlg.cpp

	// dlg.cpp : implementation file
	//
	#include <afxwin.h>
	#include "resource.h"
	#include "dlg.h"

	#ifdef _DEBUG
	#undef THIS_FILE
	static char BASED_CODE THIS_FILE[] = __FILE__;
	#endif

	/////////////////////////////////////////////////////////////////////////////
	// CDlg dialog

	CDlg::CDlg(CWnd* pParent /*=NULL*/)
		: CDialog(CDlg::IDD, pParent)
	{
		//{{AFX_DATA_INIT(CDlg)
		m_Str=””;
		//}}AFX_DATA_INIT
	}

	void CDlg::DoDataExchange(CDataExchange* pDX)
	{
		CDialog::DoDataExchange(pDX);
		//{{AFX_DATA_MAP(CDlg)
		DDX_Text(pDX, IDC_EDIT1, m_Str);
		//}}AFX_DATA_MAP
	}

	BEGIN_MESSAGE_MAP(CDlg, CDialog)
		//{{AFX_MSG_MAP(CDlg)
		ON_BN_CLICKED(IDC_CLEAR, OnClickedClear)
		//}}AFX_MSG_MAP
	END_MESSAGE_MAP()

	/////////////////////////////////////////////////////////////////////////////
	// CDlg message handlers

	BOOL CMainDlg::OnInitDialog()
	{
		CDialog::OnInitDialog();

		// TODO: Add extra initialization here

		return TRUE;  // return TRUE  unless you set the focus to a control
	}

	void CDlg::OnClickedClear()
	{
		// TODO: Add your control notification handler code here
		m_Str="";
		UpdateData(FALSE);
	}

	void CDlg::OnCancel()
	{
		// TODO: Add your control notification handler code here
		MessageBeep(0);
		CDialog::OnCancel();
	}

	void CDlg::OnOK()
	{
		// TODO: Add your control notification handler code here
		MessageBeep(0);
		CDialog::OnOK();
	}

Класс СDlg наследуется от базового класса CDialog , определенного в библиотеке классов MFC. Конструктор класса имеет один необязательный параметр pParent, используемый для передачи индекса главного окна приложения.

Следует обратить внимание на определение конструктора класса CDlg. После названия конструктора стоит двоеточие и название конструктора класса CDialog . При этом в качестве параметров ему передается идентификатор диалоговой панели и указатель на родителькое окно:

Основное назначение конструктора CDlg - вызвать конструктор класса CDialog . Именно конструктор класса CDialog выполняет создание диалоговой панели.

При отображении диалоговой панели при помощи функций DoModal (Create или CreateIndirect для немодальных диалогов), функция диалоговой панели передается сообщение WM_INITDIALOG . Непосредственного доступа к функции диалога нет. Ее реализация содержится в классе CDialog .

В ответ на сообщение WM_INITDIALOG вызывается метод OnInitDialog , объявленный как виртуальный метод класса CDialog . Этот метод вызывается непосредственно перед выводом панели на экран.

Таблица сообщений класса CDlg не содержит макрокоманд для обработки сообщения WM_INITDIALOG . Метод OnInitDialog вызывается непосредственно MFC. Чтобы реализовать собственную обработку сообщения WM_INITDIALOG, нужно просто переопределить метод OnInitDialog .

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

Если во время инициализации диалоговой панели метод OnInitDialog устанавливает фокус ввода другому органу управления, метод должен вернуть значение FALSE.

Виртуальный метод DoDataExchange , который также переопределяется в классе диалоговой панели, первоначально определен в классе CWnd . Он служит для реализации механизмов автоматического обмена данными - Dialog Data Exchange (DDX) - и автоматической проверки данных - Dialog Data Validation (DDV).

Механизм автоматического обмена данными позволяет привязать к органам управления диалоговой панели переменные или элементы данных класса диалоговой панели. Ряд специальных функций, определенных в библиотеке MFC, вызываются методом DoDataExchange и выполняют обмен данными между органами управления диалоговой панели и соответствующими элементами данных класса диалоговой панели. Такой обмен работает в обоих направлениях. Информация из органов управления диалоговой панели может записываться в элементы данных класса, или, в обратном направлении, информация из элементов данных класса может отображаться в диалоговой панели.

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

Все функции DDX_ имеют три параметра. Первый параметр содержит указатель на объект класса CDataExchange . Этот объект определяет параметры обмена, в том числе направление, в котором надо выполнить обмен данными. Второй параметр определяет идентификатор органа управления, с которым выполняется обмен данными. Третий параметр содержит ссылку на элемент данных класса диалоговой панели, связанный с данным органом управления.

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

Если функция DDV_ обнаруживает ошибку пользователя при вводе информации в органе управления, она отображает сообщение и передает фокус ввода соответствующему органу управления.

В отличие от функций DDX_ функции DDV_ в зависимости от их предназначения имеют различное количество параметров. Первый параметр, как и в случае DDX_ , содержит указатель на объект класса CDataExchange . Остальные параметры имеют различное назначение в зависимости от функций.

Если метод UpdateData вызывается с параметром FALSE (см. метод CDlg::OnClickedClear), то выполняется инициализация диалоговой панели. Информация из данных класса отображается в органах управления диалоговой панели.

В случае, если метод UpdateData вызван с параметром TRUE, данные перемещаются в обратном направлении. Из органов управления диалоговой панели они копируются в соответствующие элементы данных класса диалоговой панели.

Метод UpdateData возвращает ненулевое значение, если обмен данными прошел успешно, и нуль в противном случае. Ошибка при обмене данными может произойти, если данные копируются из диалоговой панели в элементы класса диалоговой панели и пользователь ввел неправильные данные, отвергнутые процедурой автоматической проверки данных.

При создании модальной диалоговой панели перед тем, как панель появится на экране, вызывается виртуальный метод OnInitDialog класса CDialog . По умолчанию OnInitDialog вызывает метод UpdateData и выполняет инициализацию органов управления. Если метод OnInitDialog переопределяется в классе диалоговой панели, в первую очередь необходимо вызвать метод OnInitDialog класса CDialog .

Метод UpdateData также вызывается некоторыми другими методами класса CDialog . Так, метод UpdateData вызывается, когда пользователь закрывает модальную диалоговую панель, нажимает кнопку "Ok". Заметим, что кнопка "Ok" должна иметь идентификатор IDOK . Если пользователь нажмет на кнопку "Cancel", имеющую идентификатор IDCANCEL , то диалоговая панель также закрывается, но метод UpdateData не вызывается и обмен данными не происходит.

Методу DoDataExchange , который служит для реализации механизмов автоматического обмена данными, передается указатель pDX на объект класса CDataExchange . Этот объект создается, когда инициируется процесс обмена данными вызовом функции UpdateData . Элементы данных класса CDataExchange определяют процедуру обмена данными, в том числе определяют, в каком направлении будет происходить этот обмен. Следует обратить внимание на то, что указатель pDX передается функциям DDX_ и DDV_ .

Класс диалоговой панели должен обрабатывать сообщения от своих органов управления, поэтому он должен иметь таблицу сообщений. В заголовке таблицы сообщений указывается имя класса CDlg и имя базового класса CDialog . Таблица сообщений класса CDlg содержит только одну строку, в которой обрабатывается сообщение с кодом извещения ON_BN_CLICKED от кнопки "Clear". Когда пользователь нажимает кнопку, вырабатывается данное сообщение и вызывается его обработчик - метод OnClickedClear, определенный в классе CDlg.

Две другие кнопки панели - "Ok" и "Cancel" - не представлены в таблице сообщений, но в приложении определены методы OnOK и OnCancel , которые вызываются при нажатии на них. Оказывается, для диалоговых панелей определены две стандартные кнопки - "Ok" и "Cancel", которым присвоены специальные идентификаторы IDOK и IDCANCEL.

Базовый класс CDialog , так же как и класс CMyDialog, содержит таблицу сообщений. Среди прочих сообщений в этой таблице определены командные сообщения с идентификаторами IDOK и IDCANCEL. Для обработки этих командных сообщений определены виртуальные методы OnOK и OnCancel . Поэтому, когда диалоговая панель содержит кнопки с идентификаторами IDOK и IDCANCEL , как правило, нет необходимости создавать для них обработчики.

Так как в таблице сообщений класса CDlg отсутствует макрокоманды для обработки сообщений от кнопок "Ok" и "Cancel", они передаются для обработки базовому классу CDialog . Здесь они обрабатываются виртуальными методами OnOK и OnCancel .

Метод OnOK , определенный в классе CDialog , копирует данные из полей диалоговой панели в связанные с ними переменные. Для этого вызывается метод UpdateData с параметром TRUE. Затем выполняется вызов метода EndDialog , который закрывает диалоговую панель и возвращает значение IDOK . Метод DoModal , который используется для создания диалоговой панели и вызывается в классе родительского окна, прекращает работу и возвращает IDOK .

Метод OnCancel , определенный в классе CDialog , еще проще, чем OnOK . Он только закрывает диалоговую панель и возвращает значение IDCANCEL . Копирование данных не происходит, так как пользователь отменил изменения, нажав кнопку "Cancel".

Так как методы OnOK и OnCancel определены в классе CDialog как виртуальные, то можно переопределить их в классе CDlg. В этом случае управление получат переопределенные методы, а не методы класса CDialog . Методы класса можно вызвать, явно указав класс CDialog.

Для отображения модальной диалоговой панели сначала создается объект класса CDlg, который будет представлять диалоговую панель. Когда объект создан, диалоговая панель еще не появляется на экране, для этого нужно воспользоваться методом DoModal, определенным в классе CDialog . При вызове метода DoModal выполнение метода, вызвавшего модальный диалог, приостанавливается, пока пользователь не закроет диалоговую панель.

	#include “dlg.h”
	……
	// Создание объекта класса диалога
	CDlg Dlg; 	// при необходимости можно в конструктор класса диалога
			// передать указатель на родительское окно, по умолчанию
			// диалог является модальным ко всему приложению

	int result;
	// Mожно проинициировать переменные класса
	Dlg.m_Str=”Введите текст”;

	// Проверка возвращаемого методом DoModal значения

	if((result=Dlg.DoModal())==IDOK)
	{
		// Код, который вызывается, если пользователь нажимает кнопку
 "OK"
		………
		// Можно воспользоваться данными, полученными в процессе диалога

		AfxMessageBox(MyDialog.m_Str);

	}
	else
		if(result==IDCANCEL)
		{
			// Код, который вызывается, если нажата кнопка "Cancel"

			………
		}
	……

Диалоговую панель можно использовать и как главное окно приложения. Для этого также сначала следует создать шаблон панели и сгенерировать при помощи ClassWizard класс, отвечающий за работу панели. Затем можно модифицировать шаблон и класс панели для нужд приложения и вызвать эту панель в переопределении метода InitInstance главного класса приложения, начследованного от CWinApp .

	#include <afxwin.h>
	#include файл определения главного класса приложения

	
#include файл определения класса диалога


	BOOL CApp::InitInstance()
	{
		// Создание объекта класса диалога

		CDlg Dlg;
		// Указатель на объект класса диалога присваивается переменной
		// m_pMainWnd класса CWinApp (процесс присоединения объекта
		// главного окна к объекту-приложению)

		m_pMainWnd= &Dlg;
		// Отображение на экране диалоговой панели.

		int result=Dlg.DoModal();
		// Проверка возвращаемого методом DoModal значения

		if(result==IDOK)
		{
			……
		}
		else
			if(result==IDCANCEL)
			{
				……
			}
		// Так как диалоговая панель закрыта, то следует возвратить 
		// значение FALSE, чтобы завершить работу приложения

		return FALSE;
	}

Как и в случае с модальной диалоговой панелью, в первую очередь необходимо создать шаблон диалоговой панели и добавить его в файл ресурсов приложения. Затем нужно создать класс CDlg, управляющий диалоговой панелью, - класс диалоговой панели. Этот класс наследуется непосредственно от базового класса CDialog . Затем можно модифицировать шаблон и класс панели для нужд приложения.

В классе немодального диалога следует переопределить метод Create базового класса CDialog следующим образом:

	void CDlg::Create(CWnd* pParent)
	{	CDialog::Create(IDD,pParent); // Вызов метода базового класса
		Parent=pParent; // окно-родитель

	}

Предварительно в класс диалога необходимо добавить элемент Parent - указатель на родительский объект, например, CWnd *Parent - указатель на родительское окно. Если родительский объект не окно, то можно добавить в метод Create параметр, отвечающий за передачу указателя на родительский объект, и присвоить его переменной Parent, объявив его в определении класса как указатель на объект соответствующего типа. Указатель на родительский объект позволяет при необходимости вызывать для родительского объекта методы его класса непосредственно из методов класса диалога, что обеспечивает связь немодального диалога и его родительского объекта.

В переопределенном методе Create следует обязательно вызвать метод Create базового класса CDialog . Именно этот метод создает окно диалоговой панели. В классе CDialog определены два прототипа метода Create . Один позволяет указать диалоговую панель через ее текстовое имя, а другой - через числовой идентификатор. Метод Create возвращает управление сразу после отображения на экране диалоговой панели. Он возвращает ненулевое значение, если создание диалоговой панели завершилось успешно, и нуль в противном случае.

При помощи ClassWizard в классе CDlg также следует создать заготовки методов-обработчиков сообщений от кнопок IDOK (OnOK ) и IDCANCEL (OnCancel ) и для сообщения WM_DESTROY (OnDestoy ). Затем необходимо изменить методы OnOK и OnCancel так, чтобы они вызывали только метод DestoyWindow . Если в методе Create предусматривается динамическое выделение блоков памяти, тогда в методе OnDestoy необходимо освободить занимаемую память.

В момент создания объекта класса CDlg диалоговая панель как окно еще не создана и не появляется на экране. Для этого надо вызвать метод Create класса CDlg. Если диалоговая панель имеет стиль WS_VISIBLE , то она сразу появляется на экране. В противном случае для этого надо вызвать метод ShowWindow . Итак, в методе, который вызывает немодальный диалог (например, в методе-обработчике какого-либо сообщения для окна приложения), следует проверить, не отображается ли уже эта диалоговая панель, а затем создать ее методом Create класса CDlg:

	if(Dlg.GetSafeHwnd()==NULL) Dlg.Create(this);

Чтобы закрыть немодальную диалоговую панель, можно воспользоваться методом DestroyWindow :

	if(Dlg.GetSafeHwnd()!=NULL) Dlg.DestroyWindow();

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