Visual C++. Описание стандартных классов
Страница 27.

Класс CWinApp является базовым классом для создания объектов классов приложений Windows. Объект класса представления содержит функции, позволяющие инициализировать приложение пользователя (и каждый его экземпляр), а также запускать приложение на исполнение. Каждое приложение, использующее библиотеку MFC, может содержать только один объект класса CWinApp. Этот объект создается на этапе создания глобальных объектов и уже существует к моменту вызова функции WinMain, содержащейся в библиотеке MFC. Объявление объектов классов, производных от класса CWinApp, также должно быть глобальным. Функция InitInstance, принадлежащая данному классу, служит для создания объекта класса главного окна приложения. Кроме функций класса CWinApp библиотека MFC содержит следующие функции, позволяющие получить доступ к объектам класса CWinApp и к содержащейся в них информации.

Описание данного класса содержится в файле заголовка afxwin.h. Данный класс используется во многих демонстрационных приложениях, описанных в данной книге.

Данная функция добавляет объект класса шаблона документа в список доступных шаблонов документов данного приложения. Список доступных шаблонов документов должен быть заполнен до вызова функции RegisterShellFileTypes.

Данная функция вызывается в конструкторе класса, производного от класса CWinApp, для обеспечения возможности использования в приложении справочной системы HTML. Эта функция присваивает переменной m_bUseHtmlHelp значение TRUE.

Строка, хранящаяся в файле приложения с расширением .ini, или строка, передаваемая в аргументе lpszDefault, если указанная строка не содержится в файле с расширением .ini. Максимальная длина строки, которая может быть получена подобным образом, равна величине _MAX_PATH. Если величина lpszDefault равна нулю, то возвращается пустая строка.

Данная функция возвращает строку, связанную с идентификатором, содержащимся в указанной секции раздела системного реестра, отведенного данному приложению, или в файле с расширением .ini.

Ненулевое, если инициализация прошла успешно, в противном случае - ноль.

Операционная система Windows допускает одновременную работу нескольких копий одного приложения. Процесс создания приложения концептуально подразделяется на два этапа: предварительное создание приложения, которое осуществляется при первом запуске программы на исполнение, и инициализация экземпляра приложения, которая происходит при запуске на исполнение любой копии программы, включая и первую. Данная функция вызывается функцией WinMain, принадлежащей классу главного окна. Обычно, в процессе выполнения перегруженной пользователем функции InitInstance производится создание объекта главного окна программы и устанавливается значение члена класса CWinThread::m_pMainWnd, содержащего указатель на это окно.

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

Как правило, данная функция вызывается в том случае, когда пользователь нажимает комбинацию клавиш +.При перегрузке данной функции в карту сообщений класса, производного от класса CWinApp, включается строка ON_COMMAND(ID_CONTEXT_HELP, OnContextHelp) а в таблицу акселераторов приложения включается соответствующая запись. Функция OnContextHelp переводит приложение в режим вывода контекстной справки. Указатель мыши в этом режиме представляет собой комбинацию наклонной стрелки и знака вопроса. При помещении данного указателя на элемент управления диалогового окна, элемент окна или команду меню и нажатии левой кнопки мыши на экран выводится окно контекстной справки по данному элементу.

Для вызова данной функции необходимо добавить в карту сообщений пользовательского класса, производного от класса CWinApp следующий макрос ON_COMMAND(ID_HELP, OnHelp) Обычно для вызова данной команды используется клавиша , однако, использование данной клавиши представляет собой общепринятую практику и нигде не регламентировано. По умолчанию данная функция обработки сообщения определяет контекст справки, соответствующий активному окну, диалоговому окну или команде меню, а затем вызывает на исполнение файл WinHelp.exe. Если для данного объекта не определен контекст, то используется контекст, определенный по умолчанию. Перегрузка данной функции позволяет задать контекст для объекта, отличного от объектов окна, диалогового окна, команды меню или кнопки панели инструментов, которым в данный момент принадлежит фокус ввода. В данной функции вызывается функция WinHelp, которой передается контекстный идентификатор справки.

Если это разрешено, приложение вызывает эту функцию обработки сообщения при выборе пользователем команды меню Help|Index (Справка|Предметный указатель). В этой функции вызывается функция WinHelp с аргументом HELP_INDEX. Чтобы воспользоваться данной функцией, необходимо поместить в карту сообщений класса CWinApp макрос ON_COMMAND(ID_HELP_INDEX, OnHelpIndex).

Данная функция вызывается для преобразования параметров командной строки в значения, присваиваемые элементам объекта класса CCommandLineInfo. Для заполнения каждого элемента данного объекта вызывается своя функция CCommandLineInfo::ParseParam. virtual BOOL PreTranslateMessage(MSG* pMsg); "sectiontableheader"pMsg - указатель на объект структуры MSG, содержащий обрабатываемое сообщение.