Classe de CWinApp

Article
03/15/2013

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.