Диалоговые окна MFC

Общие (стандартные) диалоги

В библиотеки MFC предусмотрено несколько классов C++, предназначенных для поддержки общих (стандартных) диалогов

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

Для использования конкретного диалога нужно выполнить следующее

Любое диалоговое окно может отображаться в двух режимах:

Класс CFileDialog

Класс CFileDialog реализует содание двух типов диалогов, который зависит от того, с каким аргументом для конструктора класса создается экземпляр - окно диалога:

"	CFileDialog openFile(TRUE);  // создается окно Open File 
"	    
"	CFileDialog saveFile(FALSE); // создается окно Save File

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

Примечание. Все перечисленные в таблице методы не могут вызываться до тех пор, пока не будет вызван метод DoModal() и пока он не вернет значение IDOK. Иначе в свойствах может храниться кодовый мусор.

Класс CFontDialog

Класс CFontDialog инкапсулирует встроенный в Windows стандартный диалог выбора шрифта. В таблице приводятся основные методы-члены класса CFontDialog.

Класс CColorDialog

Класс CColorDialog инкапсулирует стандартный диалог выбора цвета, используемый во многих Windows -приложениях для получения значений координат модели цвета RGB (RedGreenBlue) , которые затем можно передать любому методу интерфейса графических устройств GDI (Graphic Device Interface) , требующему код цвета. В таблице приводятся основные методы-члены класса CColorDialog

Класс CPageSetupDialog

Класс CPageSetupDialog инкапсулирует диалог Page Setup (параметры страницы), который используется для настройки вывода на печать.Этот диалог позволяет выбрать принтер, размер и поля печатаемой страницы. В таблице приводятся основные методы-члены класса CPageSetupDialog

Класс CPrintDialog

Класс CPrintDialog инкапсулирует стандартный диалог Print. Он содержит большинство методов класса CPageSetupDialog, за исключением методов GetMargins() и GetPaperSize(). Прочие важные функции класса CPrintDialog приведены в таблице

В отличие от методов класса CPageSetupDialog, метод CreatePrinterDC() можно вызывать без предварительного вызова метода DoModal(). Отображать этот диалог перед печатью необязательно, но класс CPrintDialog можно использовать для получения информации о принтере и контексте устройства.

Класс CFindReplaceDialog

Класс CFindReplaceDialog инкапсулирует стандартный диалог поиска и замены. В отличии от других стандартных диалогов, это окно немодальное, поэтому для отображения данного диалога нужно вызывать вместо метода DoModal() метод Create(). Метод Create() может принимать пять параметров, два первых из которых обязательны:

Принципы работы с классом CFindReplaceDialog более сложные, чем с другими классами стандартных диалогов. Мы их здесь рассматривать не будем. В таблице приводятся основные методы-члены класса CFindReplaceDialog

Подключение стандартного диалога File Open к приложению

Создайте обработчик для кнопки "Диалог File Open"

Заполните его кодом

Обработчик для щелчка по кнопке "Диалог File Open"
void CDialogsDlg::OnBnClickedBFileopen()
{
	CFileDialog openFile(TRUE); // Создать диалог
	if(openFile.DoModal() == IDOK){ // Отобразить и получить результат
		m_strResult = openFile.GetFileName(); // Сохранить имя файла
		UpdateData(FALSE); // Передать на экран
	}
}

Добавление собственного диалогового окна

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

Создание макета диалогового окна

Выберите вкладку

Выделите в нем пиктограмму

В панели Resource View выделите сгенерированный ресурс с дежурным именем IDD_DIALOG1 и через панель свойств присвойте ресурсу осмысленный идентификатор IDD_MESSAGEDLG. Не удаляйте кнопки OK и Cancel

Отредактируйте ресурс диалогового окна в соответствии с таблицей свойств

Таблица свойств диалогового ресурса IDD_MESSAGEDLG
Элемент управления	Свойство	Значение
Форма	Caption	Диалог с сообщениями и опциями
	Font(Size)	MS Sans Serif(10)
	Maximize Box	False
	Minimize Box	False
Static Text	Caption	Введите сообщение:
	Right Align Text	True
Edit Control	ID	IDC_EMESSAGE
	Multiline	True
	Auto VScroll	True
	Horizontal Scroll	True
Group Box	Caption	Выбор опции
Radio Button	ID	IDC_ROPTION1
	Caption	Опция 1
	Group	True
Radio Button	ID	IDC_ROPTION2
	Caption	Опция 2
	Group	False
Radio Button	ID	IDC_ROPTION3
	Caption	Опция 3
	Group	False
Radio Button	ID	IDC_ROPTION4
	Caption	Опция 4
	Group	False

При редактировании диалогового ресурса периодически проверяйте дизайн кнопкой Test Dialog панели инструментов Dialog Editor. Размеры элементов управления контролируйте через панель состояния дизайнера. Для выравнивания элементов пользуйтесь инструментами на панели инструментов или опциями меню Format оболочки.

Окончательный вариант макета приведен на рисунке

Отметьте, что для согласованной работы радиокнопок мы для первого переключателя установили свойство Group в состояние True. В остальных же переключателях оставили его значение по умолчанию False. Это приведет к тому, что следующие по порядку их создания радиокнопки будут объединены в группу. Новая группа начнется с нового следующего по порядку создания радиопереключателя со свойством True (но у нас только одна группа). Порядок следования радиопереключателей можно посмотреть через опцию Edit/Resource Symbols (или через контекстное меню в панели Resource View, щелкнув на узле Dialogs.rc ) в окне Resource Symbols

Отредактировать порядок радиопереключателей можно в файле Resource.h, открыв его на редактирование через панель Solution Explorer (не рекомендуется!!!)

В этом файле оболочка формирует именованные константы

Именованные константы в файле Resource.h
//{{NO_DEPENDENCIES}}
// Microsoft Visual C++ generated include file.
// Used by Dialogs.rc
//
#define IDD_DIALOGS_DIALOG              102
#define IDR_MAINFRAME                   128
#define IDD_MESSAGEDLG                  131
#define IDC_B_YESNOCANCEL               1000
#define IDC_B_ABORTRETRYIGNORE          1001
#define IDC_B_CUSTOMDIALOG              1002
#define IDC_B_WHICHOPTION               1003
#define IDC_E_RESULT                    1004
#define IDC_EMESSAGE                    1005
#define IDC_B_FILEOPEN                  1006
#define IDC_ROPTION1                    1006
#define IDC_B_EXIT                      1007
#define IDC_ROPTION2                    1007
#define IDC_ROPTION3                    1008
#define IDC_RADIO4                      1009
#define IDC_ROPTION4                    1009
............................................

Создание управляющего класса

Для управления диалоговым ресурсом создайте класс на основе базового класса CDialog. Для этого:

Выберите только что сконструированное окно приложения в режиме дизайна и через контекстное меню (или главное меню Project ) выполните опцию Add Class

Запустится мастер добавления класса, который нужно настроить в соответствии с рисунком

Убедитесь, что в поле Base class выбран CDialog

После создания класса его код должен быть размещен в двух новых файлах MsgDlg.h и MsgDlg.cpp. Убедитесь в этом через панель Solution Explorer. Удобнее при создании новых классов размещать их в отдельных файлах. Мастер Add Class создал производный класс-потомок на основании базового класса CDialog, поддерживающего диалоговые окна

Объявление производного класса CMsgDlg, наследника CDialog (код файла MsgDlg.h)
#pragma once

	
// CMsgDlg dialog
	
class CMsgDlg : public CDialog
{
	DECLARE_DYNAMIC(CMsgDlg)
	
public:
	CMsgDlg(CWnd* pParent = NULL);   // standard constructor
	virtual ~CMsgDlg();
	
// Dialog Data
	enum { IDD = IDD_MESSAGEDLG };
	
protected:
	virtual void DoDataExchange(CDataExchange* pDX);    // DDX/DDV support
	
	DECLARE_MESSAGE_MAP()
};

Добавьте две ассоциированные переменные к элементам управления. Для этого выделите в панели Переменные элементов управления диалога CMsgDlg ID (Объект связывания) Name (Имя) Type ( Тип) Category ( Категория) Accass ( Доступ) Назначение IDC_EMESSAGE m_strMessage Value CString public Для хранения значений поля редактирования IDC_ROPTION1 m_iOption Value int public Для распознавания выбранной радиокнопки

Мастер добавит в приложение код

Файл MsgDlg.h
class CMsgDlg : public CDialog
{
................................................
public:
	// Для хранения значений поля редактирования
	CString m_strMessage;
	// Для распознавания выбранной радиокнопки 
	int m_iOption;
};

Файл MsgDlg.cpp
CMsgDlg::CMsgDlg(CWnd* pParent /*=NULL*/)
	: CDialog(CMsgDlg::IDD, pParent)
	, m_strMessage(_T(""))
	, m_iOption(0)
{
}
	
void CMsgDlg::DoDataExchange(CDataExchange* pDX)
{
	CDialog::DoDataExchange(pDX);
	DDX_Text(pDX, IDC_EMESSAGE, m_strMessage);
	DDX_Radio(pDX, IDC_ROPTION1, m_iOption);
}

Для переключателя с установленным свойством Group мы назначили ассоциированную целочисленную переменную m_iOption. Значение этой переменной зависит от того, какой из переключателей группы будет выбран пользователем. При выборе первого переключателя "Опция 1" эта переменная принимает значение 0, при выборе второго - значение 1, и т.д. , поскольку в C++ нумерация элементов массива или группы начинается с нуля.

Подключение собственного диалога к приложению

Мы сконструировали собственный диалог, который теперь можно использовать точно также, как и стандартный диалог, а именно:

Решим эту задачу в соответствии со следующими пошаговыми инструкциями

Подключение диалога с прямым доступом к данным-членам класса CMsgDlg из класса-клиента CDialogsMsg

Добавьте в объявление класса-клиента переменную-экземпляр созданного нами класса CMsgDlg в соответствии с настройкой мастера, приведенной ниже. Для этого выделите в панели Class View класс CDialogsDlg и через контекстное меню откройте мастер

Мастер добавит код

Объявление в классе CDialogsDlg переменной-экземпляра класса CMsgDlg
class CDialogsDlg : public CDialog
{
..............................................
private:
	// Экземпляр класса нашего диалогового окна
	CMsgDlg m_dMsgDlg;
};

Добавьте в класс-клиент CDialogsMsg директиву препроцессора (предварительного компилятора) для подключения к нему объявления класса-сервиса CMsgDlg. Для этого через панель Solution Explorer откройте на редактирование файл DialogsMsg.h и в самом начале файла, перед объявлением класса CDialogsDlg, подключите заголовочный файл с описанием класса CMsgDlg, как показано ниже

Подключение файла с объявлением класса-сервиса CMsgDlg 
перед объявлением класса-клиента CDialogsDlg в файле DialogsDlg.h
// DialogsDlg.h : header file
//
	
#pragma once // Страж включения
#include "afxwin.h"
	
#include "MsgDlg.h"
// CDialogsDlg dialog
class CDialogsDlg : public CDialog
{
.....................................
};

Обратите внимание, что в каждом заголовочном файле, созданном оболочкой, она в самом начале файла размещает директиву препроцессора "#pragma once", которую называют стражем включения. Это связано с тем, что включение файла может быть размещено во многих местах приложения, а препроцессор должен включить в приложение только первый встретившийся экземпляр кода. Эта директива и поднимает флаг у препроцессора, заставляя его игнорировать повторные включения одного и того же кода. В реализациях других производителей компиляторов можно встретить иной прием

#ifndef ИМЯ_ВКЛЮЧАЕМОГО_ФАЙЛА
  #define ИМЯ_ВКЛЮЧАЕМОГО_ФАЙЛА
  
  	код включаемого файла
  
  #endif

Добавьте обработчик к кнопке "Сконструированный диалог", запускающий на выполнение окно нашего диалога

Обработчик кнопки "Сконструированный диалог" запуска диалога
// Обработчик кнопки "Сконструированный диалог"
void CDialogsDlg::OnBnClickedBCustomdialog()
{
	// Запросить информацию через диалог
	if(m_dMsgDlg.DoModal() == IDOK){
		m_strResult = m_dMsgDlg.m_strMessage;// Напрямую, т.к. public
		// разблокировать кнопку "Какая опция?"
		m_cWhichOption.EnableWindow(TRUE);
	}
	else
		m_strResult = "Ввод информации отменен!";
	
	// Передать на экран новое значение поля редактирования
	UpdateData(FALSE);
}

Добавьте обработчик к кнопке "Какая опция?"

Обработчик кнопки "Какая опция?"
// Обработчик кнопки "Какая опция?"
void CDialogsDlg::OnBnClickedBWhichoption()
{
	// Какая радиокнопка включена
	switch(m_dMsgDlg.m_iOption){
		case 0:
			m_strResult = "Была выбрана первая опция";
			break;
		case 1:
			m_strResult = "Была выбрана вторая опция";
			break;
		case 2:
			m_strResult = "Была выбрана третья опция";
			break;
		case 3:
			m_strResult = "Была выбрана четвертая опция";
			break;
		default:
			m_strResult = "Опция не выбрана!";
	}
	
	// Передать на экран новое значение поля редактирования
	UpdateData(FALSE);
}

Запустите приложение и убедитесь в его работоспособности

Подключение диалога с доступом к данным-членам класса CMsgDlg из класса-клиента CDialogsMsg через функции доступа

Измените в объявлении класса CMsgDlg данные-члены m_strMessage и m_iOption как private

Добавьте к классу CMsgDlg методы доступа public, возвращающие значения этих переменных:

CString GetMessage() {return m_strMessage;}

int GetOption() {return m_iOption;}

Замените в последних двух обработчиках класса CDialogsMsg прямые вызовы переменных m_strMessage и m_iOption через вызовы функций доступа

Изменение конфигурации проекта для его автономной работы

Постройте окончательный вариант приложения в режиме Release и убедитесь, что размер исполнимого файла составляет примерно 15K

Это малый размер для такой задачи и объясняется это тем, что при создании приложения мы настроили мастер на использование библиотек DLL

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

Выполните опцию Project/Dialogs Properties для нашего проекта Dialogs

Появится окно, в котором установите режим

Изменение режима в таблице свойcтв приложения
Use of MFC:	Use MFC in a Static Library

Перестройте приложение и определите размер исполнимого файла

Исполнимый файл приложения увеличился примерно до 155K. Такой файл будет работать на любом компьютере с операционной системой Windows.