Класс CWinApp

Статья
06/10/2015

Базовый класс, от которого наследуется объект windows-приложения.

class CWinApp : public CWinThread

Члены

Открытые конструкторы

Имя	Описание
CWinApp::CWinApp	Создает объект CWinApp.

Открытые методы

Имя	Описание
CWinApp::AddDocTemplate	Добавляет шаблон документов в список доступных шаблонов документов приложения.
CWinApp::AddToRecentFileList	Добавляет имя файла в последний использовавший ся список файлов (MRU).
CWinApp::ApplicationRecoveryCallback	Вызываемый платформой, когда приложение неожиданно ".
CWinApp::CloseAllDocuments	Закрывает все открытые документы.
CWinApp::CreatePrinterDC	Создает контекст устройства принтера.
CWinApp::DelRegTree	Удаляет указанный ключ и все его подразделы.
CWinApp::DoMessageBox	Средства AfxMessageBox для приложения.
CWinApp::DoWaitCursor	Преобразует курсор ожидания и состояние on.
CWinApp::EnableD2DSupport	Включает поддержку D2D приложения. Этот метод следует вызывать перед инициализацией главного окна.
CWinApp::EnableHtmlHelp	Средства HTMLHelp для приложения, а не WinHelp.
CWinApp::EnableTaskbarInteraction	Включает взаимодействие панели задач.
CWinApp::ExitInstance	Переопределение для очистки когда приложение завершает.
CWinApp::GetApplicationRecoveryParameter	Получает входной параметр для метода восстановления приложения.
CWinApp::GetApplicationRecoveryPingInterval	Возвращает продолжительность времени, диспетчер перезапуска ожидает функции обратного вызова восстановления для возврата.
CWinApp::GetApplicationRestartFlags	Возвращает флаги для диспетчера перезапуска.
CWinApp::GetAppRegistryKey	Ключ для возвращений HKEY_CURRENT_USER\"Software"\RegistryKey\ProfileName.
CWinApp::GetDataRecoveryHandler	Получает обработчик восстановления данных для этого экземпляра приложения.
CWinApp::GetFirstDocTemplatePosition	Получает положение первого шаблона документа.
CWinApp::GetHelpMode	Извлекает тип справки, используемый приложением.
CWinApp::GetNextDocTemplate	Извлекает позицию шаблона документа. Может использоваться рекурсивно.
CWinApp::GetPrinterDeviceDefaults	Получает значения по умолчанию устройства принтера.
CWinApp::GetProfileBinary	Получает двоичные данные из записи в ini-файле приложения.
CWinApp::GetProfileInt	Извлекает целое число от записи в ini-файле приложения.
CWinApp::GetProfileString	Извлекает строку из записи в ini-файле приложения.
CWinApp::GetSectionKey	Ключ для возвращений HKEY_CURRENT_USER\"Software"\RegistryKey\AppName\lpszSection.
CWinApp::HideApplication	Скрывает приложение перед закрыть все документы.
CWinApp::HtmlHelp	Вызывает функцию HTMLHelp Windows.
CWinApp::InitInstance	Переопределение для инициализации экземпляра Windows, как создать объекты окна.
CWinApp::IsTaskbarInteractionEnabled	Указывает, включено ли взаимодействие панели задач Windows 7.
CWinApp::LoadCursor	Загружает ресурс курсора.
CWinApp::LoadIcon	Загружает ресурс значка.
CWinApp::LoadOEMCursor	Загружает предварительно OEM курсор Windows, константы OCR_ определяют в WINDOWS.H.
CWinApp::LoadOEMIcon	Загружает предварительно OEM значок Windows, константы OIC_ определяют в WINDOWS.H.
CWinApp::LoadStandardCursor	Загружает курсор предопределенный Windows, константы IDC_ определяют в WINDOWS.H.
CWinApp::LoadStandardIcon	Загружает предварительно определенный значок Windows, константы IDI_ определяют в WINDOWS.H.
CWinApp::OnDDECommand	Вызываемый платформой в ответ на динамический обмен данными (DDE) выполните команду.
CWinApp::OnIdle	Переопределение выполнения зависит от приложения обработки времени простоя.
CWinApp::OpenDocumentFile	Вызываемый платформой для открытия документа из файла.
CWinApp::ParseCommandLine	Анализирует отдельные параметры и пометит в командной строке.
CWinApp::PreTranslateMessage	Сообщения фильтров, прежде чем они отправляются в функции Windows TranslateMessage и DispatchMessage.
CWinApp::ProcessMessageFilter	Некоторые перехватывает сообщения до того, как они достигнут приложения.
CWinApp::ProcessShellCommand	Обрабатывает аргументы и флаги командной строки.
CWinApp::ProcessWndProcException	Перехватывает все необработанные исключения, вызываемые обработчиков сообщений и команды приложения.
CWinApp::Register	Выполняет настраивал регистрацию.
CWinApp::RegisterWithRestartManager	Регистрирует приложение с помощью диспетчера перезапуска.
CWinApp::ReopenPreviousFilesAtRestart	Определяет обнаруживает вновь ли диспетчер перезапуска файлы, которые были открытыми, когда приложение слева.
CWinApp::RestartInstance	Обрабатывает перезапуску приложения, разработанного диспетчером перезапуска.
CWinApp::RestoreAutosavedFilesAtRestart	Определяет, возвращает ли диспетчер перезапуска autosaved файлы, когда он перезапускает приложение.
CWinApp::Run	По умолчанию выполняется цикл обработки сообщений. Переопределение настраивать цикл обработки сообщений.
CWinApp::RunAutomated	Проверяет командная строка приложения для параметра /Automation. Является устаревшей. Вместо этого используйте значение в CCommandLineInfo::m_bRunAutomated после вызова ParseCommandLine.
CWinApp::RunEmbedded	Проверяет командная строка приложения для параметра /Embedding. Является устаревшей. Вместо этого используйте значение в CCommandLineInfo::m_bRunEmbedded после вызова ParseCommandLine.
CWinApp::SaveAllModified	Пользователю предлагается сохранить все измененные документы.
CWinApp::SelectPrinter	Выберите принтер, показанный ранее пользователем в диалоговом окне печать.
CWinApp::SetHelpMode	Наборы и инициализируют тип справки, используемый приложением.
CWinApp::SupportsApplicationRecovery	Определяет восстанавливает ли диспетчер перезапуска приложения, слева.
CWinApp::SupportsAutosaveAtInterval	Определяет autosaves ли диспетчер перезапуска открытые документы в регулярном интервале.
CWinApp::SupportsAutosaveAtRestart	Определяет autosaves ли диспетчер перезапуска все открытые документы при перезапуске приложения.
CWinApp::SupportsRestartManager	Определяет, поддерживает ли приложение диспетчера перезапуска.
CWinApp::Unregister	Отменяет регистрацию всех известное, что, зарегистрированные с объектом CWinApp.
CWinApp::WinHelp	Вызывает функцию WinHelp Windows.
CWinApp::WriteProfileBinary	Записывает двоичные данные для записи в ini-файле приложения.
CWinApp::WriteProfileInt	Записывает целое число для записи в ini-файле приложения.
CWinApp::WriteProfileString	Записывает строку для записи в ini-файле приложения.

Защищенные методы

Имя	Описание
CWinApp::EnableShellOpen	Позволяет пользователю открыть файлы данных из файлового менеджера Windows.
CWinApp::LoadStdProfileSettings	Загружает стандартные параметры ini-файла и включает функцию списка файлов MRU.
CWinApp::OnContextHelp	Справка маркеров SHIFT+F1 в приложении.
CWinApp::OnFileNew	Реализует команду ID_FILE_NEW.
CWinApp::OnFileOpen	Реализует команду ID_FILE_OPEN.
CWinApp::OnFilePrintSetup	Реализует команду ID_FILE_PRINT_SETUP.
CWinApp::OnHelp	Справка F1 маркеров в рамках приложения (с использованием текущего контекста).
CWinApp::OnHelpFinder	Обрабатывает команды ID_HELP_FINDER и ID_DEFAULT_HELP.
CWinApp::OnHelpIndex	Выполняет команду ID_HELP_INDEX и предоставляет по умолчанию раздел Справки.
CWinApp::OnHelpUsing	Выполняет обработку команды ID_HELP_USING.
CWinApp::RegisterShellFileTypes	Регистрирует типы документов все приложения с файловыми менеджером Windows.
CWinApp::SetAppID	Явно задает идентификатор модели пользователя приложения для приложения. Этот метод должен быть вызван перед вызовом любой пользовательский интерфейс для пользователя (лучшее место конструктор приложения).
CWinApp::SetRegistryKey	Указывает параметры приложения быть сохранены в реестре, а не файлы INI.
CWinApp::UnregisterShellFileTypes	Отменяет регистрацию всех типов документов приложения с файловыми менеджером Windows.

Открытые члены данных

Имя	Описание
CWinApp::m_bHelpMode	Показывает, если пользователь находится в режиме, то контекста Справки (обычно призванном с SHIFT+F1).
CWinApp::m_eHelpType	Указывает тип справки, используемый приложением.
CWinApp::m_hInstance	Определяет текущий экземпляр приложения.
CWinApp::m_lpCmdLine	Указывает на null- завершенной строке, которая задает командную строку для приложения.
CWinApp::m_nCmdShow	Определяет, как окно отображаться исходная.
CWinApp::m_pActiveWnd	Указатель на главное окно контейнерного приложения, когда OLE-сервер активный в- размещения.
CWinApp::m_pszAppID	Идентификатор модели. пользователя приложения
CWinApp::m_pszAppName	Указывает имя приложения.
CWinApp::m_pszExeName	Имя модуля приложения.
CWinApp::m_pszHelpFilePath	Путь к файлу Справки приложения.
CWinApp::m_pszProfileName	Имя файла INI приложения.
CWinApp::m_pszRegistryKey	Используемый, чтобы определить полный раздел реестра для хранения параметров профиля приложения.

Защищенные члены данных

Имя	Описание
CWinApp::m_dwRestartManagerSupportFlags	Пометит, определяющее, как диспетчер перезапуска будет работать.
CWinApp::m_nAutosaveInterval	Время (в миллисекундах autosaves.
CWinApp::m_pDataRecoveryHandler	Указатель на обработчик восстановления данных для приложения.

Заметки

Объект приложения предоставляет функции-члены для инициализации приложения (а каждый его экземпляр) для запуска приложения.

Каждое приложение, которое использует классы Microsoft foundation может содержать только один объект, производный от CWinApp. Этот объект создается, когда другие глобальные объекты C++ строятся и уже доступен, когда Windows вызывает функцию WinMain, которая предоставляется библиотеки Microsoft Foundation Class. Объявите производный объект CWinApp на глобальном уровне.

При наследовании класса приложения из CWinApp, следует переопределить функцию-член InitInstance для создания объекта основного окна приложения.

В дополнение к функции-членам CWinApp, библиотеки Microsoft Foundation Class предоставляет следующие глобальные функции для получения доступа к объект CWinApp и другие глобальные сведения:

AfxGetApp получает указатель на объект CWinApp.
AfxGetInstanceHandle получает дескриптор для текущего экземпляра приложения.
AfxGetResourceHandle получает дескриптор к ресурсам приложения.
AfxGetAppName получает указатель на строку, содержащую имя приложения. Кроме того, если имеется указатель на объект CWinApp, используйте m_pszExeName чтобы получить имя приложения.

См. раздел CWinApp: класс приложения дополнительные сведения о классе CWinApp, включая описание следующих действий:

Производный CWinApp код, написанный мастером настройки приложений.
Роль CWinApp в последовательности выполнения приложения.
Реализации функции элемента по умолчанию CWinApp.
Переопределяемые методы CWinApp ключевые.

Элемент данных m_hPrevInstance больше не существует. Дополнительные сведения о обнаружить предыдущий экземпляр CWinApp см. в статье базы знаний "указывающее предыдущий экземпляр приложения" (KB106385) https://support.microsoft.com/default.aspx?scid=kb;en-us;106385.