CDialog::OnInitDialog

virtual BOOL OnInitDialog( );

Возвращаемое значение

Определяет, установило ли приложение фокус ввода на одном из элементов управления в диалоговом окне. Если функция OnInitDialog возвращает ненулевое значение, Windows устанавливают фокус ввода на первом элементе управления диалогового окна. Приложение может возвращать нулевое значение только в том случае, если оно само явно установило фокус ввода на один из элементов управления в диалоговом окне.

Примечание

Эта функция обрабатывает сообщение WM_INITDIALOG, посылаемое диалоговому окну функциями Create, CreateIndirect или DoModal, вызываемых для вывода диалогового окна на экран.

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

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

CDialog::OnOk

virtual void OnOK( );

Примечание

Функция OnOK вызывается при нажатии пользователем кнопки OK (кнопки с идентификатором IDOK).

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

Если эта функция вызывается для немодального диалогового окна, то она обязательно должна быть перегружена и вместо функции OnOK базового класса вызовите функцию DestroyWindow. Это связано с тем, что функция OnOK базового класса вызывает функцию EndDialog, делающую диалоговое окно невидимым, но не уничтожающее его.

CDocument

Класс CDocument обеспечивает основные функциональные возможности создаваемого пользователем класса документа. Документ представляет собой модуль данных, используемых пользователем в своём приложении, и обычно открывается командой File, Open и сохраняет с командой File, Save.

Класс CDocument содержит методы обеспечивающие создание документа, его загрузку и сохранения. Приложение может поддерживать больше чем один тип документа. Например, оно может работать как с электронными таблицами, так и с текстовыми документами. Каждый тип документа должен быть включён в один из шаблонов документа. Шаблон документа определяет ресурсы (например, меню, значок или таблица акселератора) используемые данным типом документа. Каждый документ содержит указатель на связанный объект CDocTemplate.

Пользователи взаимодействуют с документом через связанный с ним объект класса CView. Класс представления выполняет отображение документа в окне и преобразует вводимую пользователем информацию в соответствующие изменения в документе. Один класс документа может быть связан с несколькими классами представления. Когда пользователь открывает окно документа, приложение создает объект соответствующего класса представления и присоединяет его к документу. Шаблон документа определяет класс представления и класс окна, соответствующие данному типу документа.

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

Когда в документ вносятся изменения, каждый из связанных с ним объектов класса представления должен отразить эти изменения. Класс CDocument имеет функцию-член класса UpdateAllViews, позволяющую приложению сообщить всем связанным с данным документом объектам класса представления о том, что в документ внесены изменения и данные объекты должны внести соответствующие изменения в выводимую ими информацию. Перед закрытие документа приложение запрашивает пользователя о необходимости сохранить внесённые в него изменения.

Чтобы создать собственный класс документа:

1. Создайте класс, производный от класса CDocument.

2. Включите в него переменные для хранения пользовательских данных.

3. Создайте методы для чтения и внесения изменений в эти данные. В основном этими методами будут пользоваться связанные с документом объекты класса представления.

4. Перегрузите функцию CObject::Serialize, позволяющую читать и записывать документы на диск.

Описание данного класса содержится в файле заголовка afxwin.h.