Partager via


CWinApp, classe

La classe de base dont vous dérivez un objet application Windows.

class CWinApp : public CWinThread

Membres

Constructeurs publics

Nom

Description

CWinApp::CWinApp

Construit un objet CWinApp.

Méthodes publiques

Nom

Description

CWinApp::AddDocTemplate

Ajoute un modèle de document à la liste de modèles de document disponibles.

CWinApp::AddToRecentFileList

Ajoute un nom de fichier à la liste des derniers fichiers utilisés de (MRU).

CWinApp::ApplicationRecoveryCallback

Appelé par l'infrastructure lorsque l'application s'arrête de façon inattendue.

CWinApp::CloseAllDocuments

Ferme tous les documents ouverts.

CWinApp::CreatePrinterDC

Crée un contexte de périphérique d'impression.

CWinApp::DelRegTree

Supprime une clé spécifiée et toutes ses sous-clés.

CWinApp::DoMessageBox

Implémente AfxMessageBox pour l'application.

CWinApp::DoWaitCursor

Active ou désactive le curseur d'attente de démarrer et d'arrêt.

CWinApp::EnableD2DSupport

Active la prise en charge d' D2D d'application. Appelez cette méthode avant l'initialisation de la fenêtre principale.

CWinApp::EnableHtmlHelp

Implémente HTMLHelp pour l'application, plutôt que WinHelp.

CWinApp::EnableTaskbarInteraction

Active l'interaction de barre des tâches.

CWinApp::ExitInstance

Substitution à nettoyer lorsque votre application se termine.

CWinApp::GetApplicationRecoveryParameter

Récupère le paramètre d'entrée pour la méthode de redémarrage de l'application.

CWinApp::GetApplicationRecoveryPingInterval

Retourne la durée que le gestionnaire de redémarrage attend la fonction de rappel de redémarrage pour retourner.

CWinApp::GetApplicationRestartFlags

Retourne les balises pour le gestionnaire de redémarrage.

CWinApp::GetAppRegistryKey

Clé de retour pour HKEY_CURRENT_USER \"Software"\RegistryKey\ProfileName.

CWinApp::GetDataRecoveryHandler

Obtient le gestionnaire de récupération de données pour cette instance de l'application.

CWinApp::GetFirstDocTemplatePosition

Extrait la position du premier modèle de document.

CWinApp::GetHelpMode

Récupère le type d'aide utilisé par l'application.

CWinApp::GetNextDocTemplate

Extrait la position d'un modèle de document. Peut être utilisé de manière récursive.

CWinApp::GetPrinterDeviceDefaults

Récupère les valeurs par défaut de périphérique d'impression.

CWinApp::GetProfileBinary

Récupère des données binaires d'une entrée dans le fichier .ini de l'application.

CWinApp::GetProfileInt

Récupère un entier d'une entrée dans le fichier .ini de l'application.

CWinApp::GetProfileString

Extrait une chaîne d'entrée dans le fichier .ini de l'application.

CWinApp::GetSectionKey

Clé de retour pour HKEY_CURRENT_USER \"Software"\RegistryKey\AppName\lpszSection.

CWinApp::HideApplication

Masque l'application avant de fermer tous les documents.

CWinApp::HtmlHelp

Appelle la fonction Windows d' HTMLHelp .

CWinApp::InitInstance

La substitution pour effectuer des fenêtres instance de l'initialisation, telle que la création de vos objets window.

CWinApp::IsTaskbarInteractionEnabled

Indique si l'interaction de barre des tâches Windows 7 est activée.

CWinApp::LoadCursor

Charge une ressource curseur.

CWinApp::LoadIcon

Charge une ressource icône.

CWinApp::LoadOEMCursor

Charge un curseur intégré OEM par windows que les constantes d' OCR_ spécifiez dans WINDOWS.H.

CWinApp::LoadOEMIcon

Charge une icône prédéfinie OEM par windows que les constantes d' OIC_ spécifiez dans WINDOWS.H.

CWinApp::LoadStandardCursor

Charge un curseur prédéfini par windows que les constantes d' IDC_ spécifiez dans WINDOWS.H.

CWinApp::LoadStandardIcon

Charge une icône intégrée par windows que les constantes d' IDI_ spécifiez dans WINDOWS.H.

CWinApp::OnDDECommand

Appelé par l'infrastructure en réponse à un échange dynamique de données (DDE) exécutez la commande.

CWinApp::OnIdle

Substitution pour exécuter pendant le traitement des temps d'inactivité spécifique à l'application.

CWinApp::OpenDocumentFile

Appelé par l'infrastructure pour ouvrir un document à partir d'un fichier.

CWinApp::ParseCommandLine

Analyse des paramètres et balises dans la ligne de commande.

CWinApp::PreTranslateMessage

Messages de filtres pour qu'ils soient distribués aux fonctions Windows TranslateMessage et DispatchMessage.

CWinApp::ProcessMessageFilter

Certains messages intercepte d'avant qu'ils atteignent l'application.

CWinApp::ProcessShellCommand

Gère les arguments de ligne de commande et des balises.

CWinApp::ProcessWndProcException

Intercepte toutes les exceptions non gérées levées par le message et des gestionnaires de commandes de l'application.

CWinApp::Register

Performs avez personnalisé l'inscription.

CWinApp::RegisterWithRestartManager

Stocke l'application avec le gestionnaire de redémarrage.

CWinApp::ReopenPreviousFilesAtRestart

Détermine si le gestionnaire de redémarrage rouvre les fichiers qui étaient ouverts lorsque l'application a quitté de façon inattendue.

CWinApp::RestartInstance

Gère le redémarrage d'application initialisée par le gestionnaire de redémarrage.

CWinApp::RestoreAutosavedFilesAtRestart

Détermine si le gestionnaire de redémarrage restaure les fichiers sauvegardés automatiquement lorsqu'il redémarre l'application.

CWinApp::Run

Exécute la boucle de message par défaut. Substitution pour personnaliser la boucle de message.

CWinApp::RunAutomated

Teste la ligne de commande de l'application pour l'option d' /Automation . Obsolète. À la place, utilisez la valeur dans CCommandLineInfo::m_bRunAutomated après avoir appelé ParseCommandLine.

CWinApp::RunEmbedded

Teste la ligne de commande de l'application pour l'option d' /Embedding . Obsolète. À la place, utilisez la valeur dans CCommandLineInfo::m_bRunEmbedded après avoir appelé ParseCommandLine.

CWinApp::SaveAllModified

Invite l'utilisateur à enregistrer tous les documents modifiés.

CWinApp::SelectPrinter

Sélectionne une imprimante précédemment indiquée par un utilisateur dans une boîte de dialogue d'impression.

CWinApp::SetHelpMode

Les jeux et initialise le type d'aide utilisé par l'application.

CWinApp::SupportsApplicationRecovery

Détermine si le gestionnaire de redémarrage est récupérée une application qui a quitté de façon inattendue.

CWinApp::SupportsAutosaveAtInterval

Détermine si le gestionnaire de redémarrage enregistre les documents ouverts automatiquement à intervalle régulier.

CWinApp::SupportsAutosaveAtRestart

Détermine si le gestionnaire de redémarrage enregistre les documents ouverts lorsque l'application redémarre.

CWinApp::SupportsRestartManager

Détermine si l'application prend en charge le gestionnaire de redémarrage.

CWinApp::Unregister

Annule l'inscription tout connu pour être enregistré par l'objet d' CWinApp .

CWinApp::WinHelp

Appelle la fonction Windows d' WinHelp .

CWinApp::WriteProfileBinary

Écrit des données binaires à une entrée dans le fichier.ini de l'application.

CWinApp::WriteProfileInt

Écrit un entier à une entrée dans le fichier.ini de l'application.

CWinApp::WriteProfileString

Écrit une chaîne dans une entrée dans le fichier .ini de l'application.

Méthodes protégées

Nom

Description

CWinApp::EnableShellOpen

Permet à l'utilisateur des fichiers de données ouverts du gestionnaire de fichiers windows.

CWinApp::LoadStdProfileSettings

Charge les paramètres standard de fichier .ini et active la fonctionnalité liste des fichiers récents.

CWinApp::OnContextHelp

Utilisation de handles SHIFT+F1 dans l'application.

CWinApp::OnFileNew

Implémente la commande d' ID_FILE_NEW .

CWinApp::OnFileOpen

Implémente la commande d' ID_FILE_OPEN .

CWinApp::OnFilePrintSetup

Implémente la commande d' ID_FILE_PRINT_SETUP .

CWinApp::OnHelp

Aide F1 de handles dans l'application (en utilisant le contexte actuel).

CWinApp::OnHelpFinder

Gère les commandes d' ID_HELP_FINDER et d' ID_DEFAULT_HELP .

CWinApp::OnHelpIndex

Gère la commande d' ID_HELP_INDEX et fournit une rubrique d'aide par défaut.

CWinApp::OnHelpUsing

Gère la commande ID_HELP_USING.

CWinApp::RegisterShellFileTypes

Stocke les types de document de toute application avec le gestionnaire de fichiers windows.

CWinApp::SetAppID

Définit explicitement l'ID de modèle utilisateur de l'application pour l'application. Cette méthode doit être appelée avant que toute interface utilisateur est présentée à l'utilisateur (le meilleur emplacement est le constructeur d'application).

CWinApp::SetRegistryKey

Cause des paramètres d'application soit stocké dans le Registre au lieu des fichiers de .INI.

CWinApp::UnregisterShellFileTypes

Annule l'inscription des types de document de toute application avec le gestionnaire de fichiers windows.

Données membres publiques

Nom

Description

CWinApp::m_bHelpMode

Indique si l'utilisateur est en mode de contexte d'aide (généralement appelé avec SHIFT+F1).

CWinApp::m_eHelpType

Spécifie le type d'aide utilisé par l'application.

CWinApp::m_hInstance

Identifie l'instance actuelle de l'application.

CWinApp::m_lpCmdLine

Pointe vers une chaîne terminée par le caractère NULL qui spécifie la ligne de commande pour l'application.

CWinApp::m_nCmdShow

Spécifie comment la fenêtre doit être affichée initialement.

CWinApp::m_pActiveWnd

Pointeur vers la fenêtre principale de l'application conteneur lorsqu'un OLE serveur est actif sur place.

CWinApp::m_pszAppID

ID de modèle utilisateur de l'application

CWinApp::m_pszAppName

Spécifie le nom de l'application.

CWinApp::m_pszExeName

Le nom du module de l'application.

CWinApp::m_pszHelpFilePath

Le chemin d'accès au fichier d'aide de l'application.

CWinApp::m_pszProfileName

Le nom du fichier de .INI de l'application.

CWinApp::m_pszRegistryKey

Utilisé pour déterminer la clé de Registre complète pour stocker les paramètres de profil d'application.

Données membres protégées

Nom

Description

CWinApp::m_dwRestartManagerSupportFlags

Balises qui déterminent le gestionnaire de redémarrage se comporte.

CWinApp::m_nAutosaveInterval

La durée en millisecondes entre sauvegarde automatiquement.

CWinApp::m_pDataRecoveryHandler

Pointeur vers le gestionnaire de récupération de données pour l'application.

Notes

Un objet d'application fournit les fonctions membres pour initialiser votre application (et chaque instance de celle-ci) et pour exécuter l'application.

Chaque application qui utilise les classes MFC (Microsoft Foundation peut uniquement contenir un objet dérivé d' CWinApp. Cet objet est généré lorsque d'autres objets globaux C++ sont construits et est déjà disponible lorsque les fenêtres appelle la fonction d' WinMain , qui est fournie par la bibliothèque MFC. Déclarez votre objet dérivé d' CWinApp au niveau global.

Lorsque vous dérivez une classe d'application d' CWinApp, substituez la fonction membre d' InitInstance pour créer l'objet window principal de votre application.

En plus de les fonctions membres d' CWinApp , la bibliothèque MFC fournit les fonctions globales suivantes pour accéder à votre objet d' CWinApp et d'autres informations globales :

  • AfxGetApp obtient un pointeur vers l'objet d' CWinApp .

  • AfxGetInstanceHandle obtient un handle vers l'instance d'application actuelle.

  • AfxGetResourceHandle obtient un handle aux ressources de l'application.

  • AfxGetAppName obtient un pointeur vers une chaîne contenant le nom d'application. De même, si vous avez un pointeur vers l'objet d' CWinApp , utilisez m_pszExeName d'obtenir le nom d'application.

Consultez CWinApp : La classe d'application pour plus d'informations sur la classe d' CWinApp , notamment une vue d'ensemble des éléments suivants :

  • CWinApp- dérivé code écrit par l'Assistant Application.

  • Le rôle d'CWinApp dans l'ordre d'exécution de votre application.

  • Implémentations de fonction du membre par défaut d'CWinApp.

  • Les overridables principaux d'CWinApp.

Le membre de m_hPrevInstance n'existe plus. Pour plus d'informations sur la détection une instance précédente de CWinApp, consultez l'article de la Base de connaissances « procédure identifier une instance précédente d'une application » (KB106385) dans https://support.microsoft.com/default.aspx?scid=kb;en-us;106385.

Hiérarchie d'héritage

CObject

CCmdTarget

CWinThread

CWinApp

Configuration requise

En-tête : afxwin.h

Voir aussi

Tâches

Comment : ajouter la prise en charge du Gestionnaire de redémarrage

Référence

CWinThread, classe

Graphique de la hiérarchie