Поделиться через


Класс CWinApp

Базовый класс, от которого наследуется объект 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.

Иерархия наследования

CObject

CCmdTarget

CWinThread

CWinApp

Требования

Заголовок: afxwin.h

См. также

Задачи

Практическое руководство. Добавление поддержки диспетчера перезапуска

Ссылки

Класс CWinThread

Диаграмма иерархии