Classe CWinAppEx
CWinAppEx
gère l’état de l’application, enregistre l’état dans le Registre, charge l’état à partir du registre, initialise les gestionnaires d’applications et fournit des liens vers ces mêmes gestionnaires d’applications.
Pour plus d’informations, consultez le code source situé dans le dossier mfc
de votre installation de Visual Studio. Par exemple : %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc
.
Syntaxe
class CWinAppEx : public CWinApp
Membres
Constructeurs publics
Nom | Description |
---|---|
CWinAppEx::CWinAppEx |
Construit un objet CWinAppEx . |
Méthodes publiques
Nom | Description |
---|---|
CWinAppEx::CleanState |
Supprime des informations sur l’application du Registre Windows. |
CWinAppEx::EnableLoadWindowPlacement |
Spécifie si l’application charge la taille initiale et l’emplacement de la fenêtre de trame principale à partir du Registre. |
CWinAppEx::EnableTearOffMenus |
Active les menus déchirures pour l’application. |
CWinAppEx::EnableUserTools |
Permet à l’utilisateur de créer des commandes de menu personnalisées dans l’application. |
CWinAppEx::ExitInstance |
Appelé par l’infrastructure à partir de la fonction membre Run pour quitter cette instance de l’application. (Substitue CWinApp::ExitInstance .) |
CWinAppEx::GetBinary |
Lit les données binaires associées à la valeur de Registre spécifiée. |
CWinAppEx::GetContextMenuManager |
Retourne un pointeur vers l’objet global CContextMenuManager . |
CWinAppEx::GetDataVersion |
|
CWinAppEx::GetDataVersionMajor |
Retourne la version principale de l’application enregistrée dans le Registre Windows. |
CWinAppEx::GetDataVersionMinor |
Retourne la version mineure de l’application enregistrée dans le Registre Windows. |
CWinAppEx::GetInt |
Lit les données numériques associées à la valeur spécifiée à partir du Registre. |
CWinAppEx::GetKeyboardManager |
Retourne un pointeur vers l’objet global CKeyboardManager . |
CWinAppEx::GetMouseManager |
Retourne un pointeur vers l’objet global CMouseManager . |
CWinAppEx::GetObject |
Lit CObject données dérivées associées à la valeur spécifiée du Registre. |
CWinAppEx::GetRegSectionPath |
Retourne une chaîne qui est le chemin d’accès d’une clé de Registre. Ce chemin concatène le chemin d’accès relatif fourni avec le chemin d’accès de l’application. |
CWinAppEx::GetRegistryBase |
Retourne le chemin du Registre de l’application. |
CWinAppEx::GetSectionBinary |
Lit les données binaires associées à la clé et à la valeur spécifiées à partir du Registre. |
CWinAppEx::GetSectionInt |
Lit les données numériques du Registre associées à la clé et à la valeur spécifiées. |
CWinAppEx::GetSectionObject |
Lit CObject données associées à la clé et à la valeur spécifiées à partir du Registre. |
CWinAppEx::GetSectionString |
Lit les données de chaîne associées à la clé et à la valeur spécifiées à partir du Registre. |
CWinAppEx::GetShellManager |
Retourne un pointeur vers l’objet global CShellManager . |
CWinAppEx::GetString |
Lit les données de chaîne associées à la valeur spécifiée à partir du Registre. |
CWinAppEx::GetTooltipManager |
Retourne un pointeur vers l’objet global CTooltipManager . |
CWinAppEx::GetUserToolsManager |
Retourne un pointeur vers l’objet global CUserToolsManager . |
CWinAppEx::InitContextMenuManager |
Initialise l'objet CContextMenuManager . |
CWinAppEx::InitKeyboardManager |
Initialise l'objet CKeyboardManager . |
CWinAppEx::InitMouseManager |
Initialise l'objet CMouseManager . |
CWinAppEx::InitShellManager |
Initialise la classe CShellManager |
CWinAppEx::InitTooltipManager |
Initialise la classe CTooltipManager . |
CWinAppEx::IsResourceSmartUpdate |
|
CWinAppEx::IsStateExists |
Indique si la clé spécifiée se trouve dans le Registre. |
CWinAppEx::LoadState |
Charge l’état de l’application à partir du Registre. |
CWinAppEx::OnAppContextHelp |
Appelé par l’infrastructure lorsque l’utilisateur demande de l’aide contextuelle pour la boîte de dialogue Personnalisation. |
CWinAppEx::OnViewDoubleClick |
Appelle la commande définie par l’utilisateur lorsque l’utilisateur double-clique n’importe où dans l’application. |
CWinAppEx::OnWorkspaceIdle |
|
CWinAppEx::SaveState |
Écrit l’état de l’infrastructure d’application dans le Registre Windows. |
CWinAppEx::SetRegistryBase |
Définit le chemin d’accès de la clé de Registre par défaut. Cette clé servira de racine pour tous les appels de Registre suivants. |
CWinAppEx::ShowPopupMenu |
Affiche un menu contextuel. |
CWinAppEx::WriteBinary |
Écrit les données binaires dans la valeur de Registre spécifiée. |
CWinAppEx::WriteInt |
Écrit les données numériques dans la valeur de Registre spécifiée. |
CWinAppEx::WriteObject |
Écrit les données dérivées de la CObject Classe dans la valeur de Registre spécifiée. |
CWinAppEx::WriteSectionBinary |
Écrit les données binaires dans une valeur de la clé de Registre spécifiée. |
CWinAppEx::WriteSectionInt |
Écrit les données numériques dans une valeur de la clé de Registre spécifiée. |
CWinAppEx::WriteSectionObject |
Écrit les données dérivées de la classe CObject dans une valeur de la clé de Registre spécifiée. |
CWinAppEx::WriteSectionString |
Écrit les données de chaîne dans une valeur de la clé de Registre spécifiée. |
CWinAppEx::WriteString |
Écrit les données de chaîne dans la valeur de Registre spécifiée. |
Méthodes protégées
Nom | Description |
---|---|
CWinAppEx::LoadCustomState |
Appelé par l’infrastructure lorsque l’état de l’application a été chargé. |
CWinAppEx::LoadWindowPlacement |
Appelé par l’infrastructure lorsqu’il charge la taille et l’emplacement de votre application à partir du Registre. Les données chargées incluent la taille et l’emplacement de l’image principale au moment de la dernière fermeture de votre application. |
CWinAppEx::OnClosingMainFrame |
Appelé par l’infrastructure lorsqu’une fenêtre de trame principale traite WM_CLOSE . |
CWinAppEx::PreLoadState |
Appelé par l’infrastructure immédiatement avant le chargement de l’état de l’application. |
CWinAppEx::PreSaveState |
Appelé par l’infrastructure immédiatement avant l’enregistrement de l’état de l’application. |
CWinAppEx::ReloadWindowPlacement |
Recharge la taille et l’emplacement de la fenêtre fournie à partir du Registre |
CWinAppEx::SaveCustomState |
Appelé par l’infrastructure après avoir écrit l’état de l’application dans le Registre. |
CWinAppEx::StoreWindowPlacement |
Appelé par l’infrastructure pour écrire la taille et l’emplacement du cadre principal dans le Registre. |
Données membres
Nom | Description |
---|---|
CWinAppEx::m_bForceImageReset |
Spécifie si l’infrastructure réinitialise toutes les images de barre d’outils lorsque la fenêtre frame qui contient la barre d’outils est chargée. |
Notes
La plupart des fonctionnalités fournies par l’infrastructure MFC dépendent de la classe CWinAppEx
. Vous pouvez incorporer la classe CWinAppEx
dans votre application de l’une des deux manières suivantes :
Construisez une classe
CWinAppEx
dans le thread principal.Dérivez la classe d’application principale de
CWinAppEx
.
Après avoir incorporé CWinAppEx
dans votre application, vous pouvez initialiser l’un des gestionnaires d’applications. Avant d’utiliser un gestionnaire d’applications, vous devez l’initialiser en appelant la méthode initialiser appropriée. Pour obtenir un pointeur vers un gestionnaire spécifique, appelez la méthode get associée. La classe CWinAppEx
gère les gestionnaires d’applications suivants : CMouseManager
Classe, CContextMenuManager
Classe, CKeyboardManager
Classe, CUserToolsManager
Classeet CMenuTearOffManager
Classe.
Hiérarchie d'héritage
Spécifications
En-tête : afxwinappex.h
CWinAppEx::CleanState
Supprime toutes les informations relatives à l’application du Registre Windows.
virtual BOOL CleanState(LPCTSTR lpszSectionName=NULL);
Paramètres
lpszSectionName
[in] Chaîne qui contient un chemin d’accès d’une clé de Registre.
Valeur de retour
Différent de zéro si la méthode a réussi ; sinon 0.
Notes
Cette méthode efface les données d’application d’une section spécifique du Registre. Vous pouvez spécifier la section à effacer à l’aide du paramètre lpszSectionName
. Si lpszSectionName
est NULL
, cette méthode utilise le chemin d’accès de Registre par défaut stocké dans l’objet CWinAppEx
. Pour obtenir le chemin d’accès au Registre par défaut, utilisez CWinAppEx::GetRegistryBase.
CWinAppEx::CWinAppEx
Construit un objet CWinAppEx
.
CWinAppEx(BOOL bResourceSmartUpdate = FALSE);
Paramètres
bResourceSmartUpdate
[in] Paramètre booléen qui spécifie si l’objet de l’espace de travail doit détecter et gérer les mises à jour des ressources.
Notes
La classe CWinAppEx
a des méthodes d’initialisation, fournit des fonctionnalités permettant d’enregistrer et de charger des informations sur l’application dans le Registre et de contrôler les paramètres globaux de l’application. Cela vous permet également d’utiliser des gestionnaires globaux tels que la CKeyboardManager
Classe et la CUserToolsManager
Classe. Chaque application ne peut avoir qu’une seule instance de la classe CWinAppEx
.
CWinAppEx::EnableLoadWindowPlacement
Spécifie si l’application charge la taille initiale et l’emplacement de la fenêtre de trame principale à partir du Registre.
void EnableLoadWindowPlacement(BOOL bEnable = TRUE);
Paramètres
bEnable
[in] Spécifie si l’application charge la taille initiale et l’emplacement de la fenêtre de trame principale à partir du Registre.
Notes
Par défaut, la taille et l’emplacement du cadre principal sont chargés à partir du Registre avec d’autres paramètres d’application. Cela se produit pendant CWinAppEx::LoadState
. Si vous ne souhaitez pas charger l’emplacement de la fenêtre initiale à partir du Registre, appelez cette méthode avec bEnable
défini sur FALSE
.
CWinAppEx::EnableTearOffMenus
Crée et initialise un objet CMenuTearOffManager
.
BOOL EnableTearOffMenus(
LPCTSTR lpszRegEntry,
const UINT uiCmdFirst,
const UINT uiCmdLast);
Paramètres
lpszRegEntry
[in] Chaîne qui contient le chemin d’accès d’une clé de Registre. L’application utilise cette clé de Registre pour stocker des informations pour les menus déchirants.
uiCmdFirst
[in] Premier ID de menu déchirure.
uiCmdLast
[in] L’ID de menu de la dernière déchirure.
Valeur de retour
TRUE
si le CMenuTearOffManager
est créé et initialisé avec succès ; FALSE
si une erreur se produit ou si le CMenuTearOffManager
existe déjà.
Notes
Utilisez cette fonction pour activer les menus déchirures dans votre application. Vous devez appeler cette fonction à partir de InitInstance
.
CWinAppEx::EnableUserTools
Permet à l’utilisateur de créer des commandes de menu personnalisées qui réduisent les séquences de touches dans votre application. Cette méthode crée un objet CUserToolsManager
.
BOOL EnableUserTools(
const UINT uiCmdToolsDummy,
const UINT uiCmdFirst,
const UINT uiCmdLast,
CRuntimeClass* pToolRTC = RUNTIME_CLASS(CUserTool),
UINT uArgMenuID = 0,
UINT uInitDirMenuID = 0);
Paramètres
uiCmdToolsDummy
[in] Entier non signé que l’infrastructure utilise comme espace réservé pour l’ID de commande du menu outils utilisateur.
uiCmdFirst
[in] ID de commande de la première commande de l’outil utilisateur.
uiCmdLast
[in] ID de commande de la dernière commande de l’outil utilisateur.
pToolRTC
[in] Classe utilisée par l’objet CUserToolsManager
pour créer de nouveaux outils utilisateur.
uArgMenuID
[in] ID du menu argument.
uInitDirMenuID
[in] ID de menu du répertoire d’outils initial.
Valeur de retour
TRUE
si la méthode crée et initialise un CUserToolsManager
objet ; FALSE
si la méthode échoue ou si un objet CUserToolsManager
existe déjà.
Notes
Lorsque vous activez les outils définis par l’utilisateur, l’infrastructure prend automatiquement en charge un menu dynamique qui peut être étendu pendant la personnalisation. L’infrastructure associe chaque nouvel élément à une commande externe. L’infrastructure appelle ces commandes lorsque l’utilisateur sélectionne l’élément approprié dans le menu Tools.
Chaque fois que l’utilisateur ajoute un nouvel élément, l’infrastructure crée un objet. Le type de classe pour le nouvel objet est défini par pToolRTC
. Le type de classe pToolRTC
doit être dérivé de CUserTool
Classe.
Pour plus d’informations sur les outils utilisateur et leur incorporation dans votre application, consultez Outils définis par l’utilisateur.
CWinAppEx::ExitInstance
virtual int ExitInstance();
Valeur de retour
Notes
CWinAppEx::GetBinary
Lit les données binaires à partir d’une clé de Registre spécifiée.
BOOL GetBinary(
LPCTSTR lpszEntry,
LPBYTE* ppData,
UINT* pBytes);
Paramètres
lpszEntry
[in] Chaîne qui contient le nom d’une clé de Registre.
ppData
[out] Pointeur vers la mémoire tampon que la méthode remplit avec les données binaires.
pBytes
[out] Pointeur vers un entier non signé que la méthode utilise pour écrire le nombre d’octets lus.
Valeur de retour
TRUE
en cas de réussite ; sinon FALSE
.
Notes
Cette méthode lit les données binaires écrites dans le Registre. Pour écrire des données dans le Registre, utilisez les méthodes CWinAppEx::WriteBinary
et CWinAppEx::WriteSectionBinary
.
Le paramètre lpszEntry
est le nom d’une entrée de Registre située sous la clé de Registre par défaut pour votre application. Pour obtenir ou définir la clé de Registre par défaut, utilisez les méthodes CWinAppEx::GetRegistryBase
et CWinAppEx::SetRegistryBase
respectivement.
CWinAppEx::GetContextMenuManager
Retourne un pointeur vers l’objet global CContextMenuManager
.
CContextMenuManager* GetContextMenuManager();
Valeur de retour
Pointeur vers l’objet global CContextMenuManager
.
Notes
Si l’objet CContextMenuManager
n’est pas initialisé, cette fonction appelle CWinAppEx::InitContextMenuManager
avant de renvoyer un pointeur.
CWinAppEx::GetDataVersion
int GetDataVersion() const;
Valeur de retour
Notes
CWinAppEx::GetDataVersionMajor
Retourne la version principale de l’application enregistrée dans le Registre Windows lorsque vous appelez CWinAppEx::SaveState
.
int GetDataVersionMajor() const;
Valeur de retour
Valeur entière qui contient le numéro de version principale.
CWinAppEx::GetDataVersionMinor
Retourne la version mineure de l’application enregistrée dans le Registre Windows lorsque vous appelez CWinAppEx::SaveState
.
int GetDataVersionMinor() const;
Valeur de retour
Valeur entière qui contient le numéro de version secondaire.
CWinAppEx::GetInt
Lit les données entières d’une clé de Registre spécifiée.
int GetInt(
LPCTSTR lpszEntry,
int nDefault = 0);
Paramètres
lpszEntry
[in] Chaîne qui contient le nom d’une entrée de Registre.
nDefault
[in] Valeur par défaut retournée par la méthode si l’entrée de Registre spécifiée n’existe pas.
Valeur de retour
Données du Registre si la méthode a réussi ; sinon, nDefault
.
Notes
Cette méthode lit les données entières du Registre. Si aucune donnée entière n’est associée à la clé de Registre indiquée par lpszEntry
, cette méthode retourne nDefault
. Pour écrire des données dans le Registre, utilisez les méthodes CWinAppEx::WriteSectionInt
et CWinAppEx::WriteInt
.
Le paramètre lpszEntry
est le nom d’une entrée de Registre située sous la clé de Registre par défaut pour votre application. Pour obtenir ou définir la clé de Registre par défaut, utilisez les méthodes CWinAppEx::GetRegistryBase
et CWinAppEx::SetRegistryBase
respectivement.
CWinAppEx::GetKeyboardManager
Retourne un pointeur vers l’objet global CKeyboardManager
.
CKeyboardManager* GetKeyboardManager();
Valeur de retour
Pointeur vers l’objet global CKeyboardManager
.
Notes
Si le gestionnaire de clavier n’est pas initialisé, cette fonction appelle CWinAppEx::InitKeyboardManager
avant de renvoyer un pointeur.
CWinAppEx::GetMouseManager
Retourne un pointeur vers l’objet global CMouseManager
.
CMouseManager* GetMouseManager();
Valeur de retour
Pointeur vers l’objet global CMouseManager
.
Notes
Si le gestionnaire de souris n’est pas initialisé, cette fonction appelle CWinAppEx::InitMouseManager
avant de renvoyer un pointeur.
CWinAppEx::GetObject
Lit les données conservées CObject
dans le registre.
BOOL GetObject(
LPCTSTR lpszEntry,
CObject& obj);
Paramètres
lpszEntry
[in] Chaîne qui contient le chemin d’accès relatif d’une entrée de Registre.
obj
[out] Référence à un CObject
. La méthode utilise cette référence pour stocker les données du Registre.
Valeur de retour
Différent de zéro si la méthode a réussi ; sinon 0.
Notes
Cette méthode lit les données du Registre dérivées de CObject
. Pour écrire des données CObject
dans le Registre, utilisez CWinAppEx::WriteObject
ou CWinAppEx::WriteSectionObject
.
Le paramètre lpszEntry
est le nom d’une entrée de Registre située sous la clé de Registre par défaut pour votre application. Pour obtenir ou définir la clé de Registre par défaut, utilisez les méthodes CWinAppEx::GetRegistryBase
et CWinAppEx::SetRegistryBase
respectivement.
CWinAppEx::GetRegistryBase
Récupère le chemin d’accès du Registre par défaut pour l’application.
LPCTSTR GetRegistryBase();
Valeur de retour
Chaîne qui contient le chemin d’accès de l’emplacement du Registre par défaut.
Notes
Toutes les méthodes de la CWinAppEx
Classe qui accèdent au registre démarrent à un emplacement par défaut. Utilisez cette méthode pour récupérer un chemin d’accès de l’emplacement de Registre par défaut. Utilisez CWinAppEx::SetRegistryBase
pour modifier l’emplacement du Registre par défaut.
CWinAppEx::GetRegSectionPath
Crée et retourne le chemin absolu d’une clé de Registre.
CString GetRegSectionPath(LPCTSTR szSectionAdd = _T(""));
Paramètres
szSectionAdd
[in] Chaîne qui contient le chemin d’accès relatif d’une clé de Registre.
Valeur de retour
Un CString
qui contient le chemin absolu d’une clé de Registre.
Notes
Cette méthode définit le chemin absolu de la clé de Registre en ajoutant le chemin relatif dans szSectionAdd
à l’emplacement de Registre par défaut de votre application. Pour obtenir la clé de Registre par défaut, utilisez la méthode CWinAppEx::GetRegistryBase
.
CWinAppEx::GetSectionBinary
Lit les données binaires à partir du Registre.
BOOL GetSectionBinary(
LPCTSTR lpszSubSection,
LPCTSTR lpszEntry,
LPBYTE* ppData,
UINT* pBytes);
Paramètres
lpszSubSection
[in] Chaîne qui contient le chemin d’accès relatif d’une clé de Registre.
lpszEntry
[in] Chaîne qui contient la valeur à lire.
ppData
[out] Pointeur vers la mémoire tampon où la méthode stocke les données.
pBytes
[out] Pointeur vers un entier non signé. La méthode écrit la taille de ppData
dans ce paramètre.
Valeur de retour
TRUE
en cas de réussite ; sinon, FALSE
.
Notes
Cette méthode lit les données binaires écrites dans le Registre à l’aide des méthodes CWinAppEx::WriteBinary
et CWinAppEx::WriteSectionBinary
.
Le paramètre lpszSubSection
n’est pas un chemin absolu pour une entrée de Registre. Il s’agit d’un chemin relatif ajouté à la fin de la clé de Registre par défaut pour votre application. Pour obtenir ou définir la clé de Registre par défaut, utilisez les méthodes CWinAppEx::GetRegistryBase
et CWinAppEx::SetRegistryBase
respectivement.
CWinAppEx::GetSectionInt
Lit les données entières du Registre.
int GetSectionInt(
LPCTSTR lpszSubSection,
LPCTSTR lpszEntry,
int nDefault = 0);
Paramètres
lpszSubSection
[in] Chaîne qui contient le chemin d’accès relatif d’une clé de Registre.
lpszEntry
[in] Chaîne qui contient la valeur à lire.
nDefault
[in] Valeur par défaut à retourner si la valeur spécifiée n’existe pas.
Valeur de retour
Données entières stockées dans la valeur de Registre spécifiée ; nDefault
si les données n’existent pas.
Notes
Utilisez les méthodes CWinAppEx::WriteInt
et CWinAppEx::WriteSectionInt
pour écrire des données entières dans le Registre.
Le paramètre lpszSubSection
n’est pas un chemin absolu d’une entrée de Registre. Il s’agit d’un chemin relatif ajouté à la fin de la clé de Registre par défaut pour votre application. Pour obtenir ou définir la clé de Registre par défaut, utilisez les méthodes CWinAppEx::GetRegistryBase
et CWinAppEx::SetRegistryBase
respectivement.
CWinAppEx::GetSectionObject
Lit CObject
données de Registre à partir du Registre.
BOOL GetSectionObject(
LPCTSTR lpszSubSection,
LPCTSTR lpszEntry,
CObject& obj);
Paramètres
lpszSubSection
[in] Chaîne qui contient le chemin d’accès relatif d’une clé de Registre.
lpszEntry
[in] Chaîne qui contient la valeur à lire.
obj
[out] Référence à un CObject
. La méthode utilise CObject
pour stocker les données du Registre.
Valeur de retour
Valeur différente de zéro cas de réussite ; sinon, 0.
Notes
Cette méthode lit les données du Registre. Les données lues sont des données CObject
ou des données pour une classe dérivée de CObject
. Pour écrire des données CObject
dans le Registre, utilisez CWinAppEx::WriteObject
ou CWinAppEx::WriteSectionObject
.
Le paramètre lpszSubSection
n’est pas un chemin absolu pour une entrée de Registre. Il s’agit d’un chemin relatif ajouté à la fin de la clé de Registre par défaut pour votre application. Pour obtenir ou définir la clé de Registre par défaut, utilisez les méthodes CWinAppEx::GetRegistryBase
et CWinAppEx::SetRegistryBase
respectivement.
CWinAppEx::GetSectionString
Lit les données de chaîne à partir du Registre.
CString GetSectionString(
LPCTSTR lpszSubSection,
LPCTSTR lpszEntry,
LPCTSTR lpszDefault = _T(""));
Paramètres
lpszSubSection
[in] Chaîne qui contient le chemin d’accès relatif d’une clé de Registre.
lpszEntry
[in] Chaîne qui contient la valeur à lire.
lpszDefault
[in] Valeur par défaut à retourner si la valeur spécifiée n’existe pas.
Valeur de retour
Données de chaîne stockées dans la valeur de Registre spécifiée si les données existent ; sinon, lpszDefault
.
Notes
Cette méthode lit les données de chaîne écrites dans le Registre. Utilisez CWinAppEx::WriteString
et CWinAppEx::WriteSectionString
pour écrire des données de chaîne dans le Registre.
Le paramètre lpszSubSection
n’est pas un chemin absolu pour une entrée de Registre. Il s’agit d’un chemin relatif ajouté à la fin de la clé de Registre par défaut pour votre application. Pour obtenir ou définir la clé de Registre par défaut, utilisez les méthodes CWinAppEx::GetRegistryBase
et CWinAppEx::SetRegistryBase
respectivement.
CWinAppEx::GetShellManager
Retourne un pointeur vers l’objet global CShellManager
.
CShellManager* GetShellManager();
Valeur de retour
Pointeur vers l’objet global CShellManager
.
Notes
Si l’objet CShellManager
n’est pas initialisé, cette fonction appelle CWinAppEx::InitShellManager
avant de renvoyer un pointeur.
CWinAppEx::GetString
Lit les données de chaîne à partir d’une clé de Registre spécifiée.
CString GetString(
LPCTSTR lpszEntry,
LPCTSTR lpzDefault= _T(""));
Paramètres
lpszEntry
[in] Chaîne qui contient le nom d’une clé de Registre
lpzDefault
[in] Valeur par défaut retournée par la méthode si l’entrée de Registre spécifiée n’existe pas.
Valeur de retour
Données de chaîne stockées dans le Registre en cas de réussite ; sinon lpszDefault
.
Notes
Cette méthode lit les données de chaîne écrites dans le Registre. Pour écrire des données dans le Registre, utilisez les méthodes CWinAppEx::WriteString
ou CWinAppEx::WriteSectionString
.
Le paramètre lpszEntry
est le nom d’une entrée de Registre située sous la clé de Registre par défaut pour votre application. Pour obtenir ou définir la clé de Registre par défaut, utilisez les méthodes CWinAppEx::GetRegistryBase
et CWinAppEx::SetRegistryBase
respectivement.
CWinAppEx::GetTooltipManager
Retourne un pointeur vers l’objet global CTooltipManager
.
CTooltipManager* GetTooltipManager();
Valeur de retour
Pointeur vers l’objet global CTooltipManager
.
Notes
Si l’objet CTooltipManager
n’est pas initialisé, cette fonction appelle CWinAppEx::InitTooltipManager
avant de renvoyer un pointeur.
CWinAppEx::GetUserToolsManager
Retourne un pointeur vers l’objet global CUserToolsManager
.
CUserToolsManager* GetUserToolsManager();
Valeur de retour
Pointeur vers l’objet global CUserToolsManager
; NULL
si la gestion des outils utilisateur n’est pas activée pour l’application.
Notes
Avant de récupérer un pointeur vers l’objet CUserToolsManager
, vous devez initialiser le gestionnaire en appelant CWinAppEx::EnableUserTools
.
CWinAppEx::InitContextMenuManager
Initialise l'objet CContextMenuManager
.
BOOL InitContextMenuManager();
Valeur de retour
Différent de zéro si la méthode crée l’objet CContextMenuManager
; 0 si l’objet CContextMenuManager
existe déjà.
Notes
Si vous appelez CWinAppEx::GetContextMenuManager
, l’implémentation par défaut de cette méthode appelle InitContextMenuManager
.
Si votre application dispose déjà d’un gestionnaire de menus contextuels et que vous appelez InitContextMenuManager
, votre application a un échec ASSERT
. Par conséquent, vous ne devez pas appeler InitContextMenuManager
si vous créez un objet CContextMenuManager
directement. Si vous n’utilisez pas de CContextMenuManager
personnalisé, vous devez utiliser GetContextMenuManager
pour créer un objet CContextMenuManager
.
CWinAppEx::InitKeyboardManager
Initialise l'objet CKeyboardManager
.
BOOL InitKeyboardManager();
Valeur de retour
Différent de zéro si la méthode crée l’objet CKeyboardManager
; 0 si l’objet CKeyboardManager
existe déjà.
Notes
Si vous appelez CWinAppEx::GetKeyboardManager
, l’implémentation par défaut de cette méthode appelle InitKeyboardManager
.
Si votre application dispose déjà d’un gestionnaire de clavier et que vous appelez InitKeyboardManager
, votre application a un échec ASSERT
. Par conséquent, vous ne devez pas appeler InitKeyboardManager
si vous créez directement un objet CKeyboardManager
. Si vous n’utilisez pas de CKeyboardManager
personnalisé, vous devez utiliser GetKeyboardManager
pour créer un objet CKeyboardManager
.
CWinAppEx::InitMouseManager
Initialise l'objet CMouseManager
.
BOOL InitMouseManager();
Valeur de retour
Différent de zéro si la méthode crée l’objet CMouseManager
; 0 si l’objet CMouseManager
existe déjà.
Notes
Si vous appelez CWinAppEx::GetMouseManager
, l’implémentation par défaut de cette méthode appelle InitMouseManager
.
Si votre application dispose déjà d’un gestionnaire de souris et que vous appelez InitMouseManager
, votre application a une défaillance ASSERT
. Par conséquent, vous ne devez pas appeler InitMouseManager
si vous créez directement un objet CMouseManager
. Si vous n’utilisez pas de CMouseManager
personnalisé, vous devez utiliser GetMouseManager
pour créer un objet CMouseManager
.
CWinAppEx::InitShellManager
Initialise l'objet CShellManager
.
BOOL InitShellManager();
Valeur de retour
Différent de zéro si la méthode crée l’objet CShellManager
; 0 si l’objet CShellManager
existe déjà.
Notes
Si vous appelez CWinAppEx::GetShellManager
, l’implémentation par défaut de cette méthode appelle InitShellManager
.
Si votre application dispose déjà d’un gestionnaire d’interpréteurs de commandes et que vous appelez InitShellManager
, votre application déclenche un échec ASSERT
. Par conséquent, n’appelez pas InitShellManager
si vous créez directement un objet CShellManager
. Si vous n’utilisez pas de CShellManager
personnalisé, utilisez GetShellManager
pour créer un objet CShellManager
.
CWinAppEx::InitTooltipManager
Initialise l'objet CTooltipManager
.
BOOL InitTooltipManager();
Valeur de retour
Différent de zéro si la méthode crée l’objet CTooltipManager
; 0 si l’objet CTooltipManager
existe déjà.
Notes
Si vous appelez CWinAppEx::GetTooltipManager
, l’implémentation par défaut de cette méthode appelle InitTooltipManager
.
Si votre application dispose déjà d’un gestionnaire d’info-bulles et que vous appelez InitTooltipManager
, votre application a une défaillance ASSERT
. Par conséquent, vous ne devez pas appeler InitTooltipManager
si vous créez directement un objet CTooltipManager
. Si vous n’utilisez pas de CTooltipManager
personnalisé, vous devez utiliser GetTooltipManager
pour créer un objet CTooltipManager
.
CWinAppEx::IsResourceSmartUpdate
BOOL IsResourceSmartUpdate() const;
Valeur de retour
Notes
CWinAppEx::IsStateExists
Indique si la clé spécifiée se trouve dans le Registre.
BOOL IsStateExists(LPCTSTR lpszSectionName);
Paramètres
lpszSectionName
[in] Chaîne qui contient un chemin d’accès d’une clé de Registre.
Valeur de retour
Différent de zéro si la clé se trouve dans le Registre ; sinon 0.
CWinAppEx::LoadCustomState
L’infrastructure appelle cette méthode après avoir chargé l’état de l’application à partir du Registre.
virtual void LoadCustomState();
Notes
Remplacez cette méthode si vous souhaitez effectuer un traitement après le chargement de l’état de l’application à partir du Registre. Par défaut, cette méthode ne fait rien.
Pour charger des informations d’état personnalisées à partir du Registre, les informations doivent d’abord être enregistrées à l’aide de CWinAppEx::SaveCustomState
.
CWinAppEx::LoadState
Lit l’état de l’application à partir du Registre Windows.
BOOL LoadState(
CMDIFrameWndEx* pFrame,
LPCTSTR lpszSectionName = NULL);
BOOL LoadState(
CFrameWndEx* pFrame,
LPCTSTR lpszSectionName = NULL);
BOOL LoadState(
COleIPFrameWndEx* pFrame,
LPCTSTR lpszSectionName = NULL);
virtual BOOL LoadState(
LPCTSTR lpszSectionName = NULL,
CFrameImpl* pFrameImpl = NULL);
Paramètres
pFrame
[in] Pointeur vers un objet de fenêtre frame. La méthode applique les informations d’état dans le Registre à cette fenêtre frame.
lpszSectionName
[in] Chaîne qui contient le chemin d’accès relatif d’une clé de Registre.
pFrameImpl
[in] Pointeur vers un objet CFrameImpl
. La méthode applique les informations d’état dans le Registre à cette fenêtre frame.
Valeur de retour
Différent de zéro si cela ; Sinon, 0.
Notes
Cette méthode charge l’état de l’application et toutes les informations d’état pour une fenêtre frame. Les informations chargées pour la fenêtre frame sont appliquées à la fenêtre frame fournie. Si vous ne fournissez pas de fenêtre frame, seules les informations d’état de l’application sont chargées. Les informations d’application incluent l’état de ClasseCMouseManager
, CContextMenuManager
Classe, CKeyboardManager
Classeet CUserToolsManager
Classe.
L’implémentation par défaut de CFrameImpl::OnLoadFrame
utilise LoadState
.
Le paramètre lpszSectionName
n’est pas le chemin absolu d’une entrée de Registre. Il s’agit d’un chemin relatif ajouté à la fin de la clé de Registre par défaut pour votre application. Pour obtenir ou définir la clé de Registre par défaut, utilisez les méthodes CWinAppEx::GetRegistryBase
et CWinAppEx::SetRegistryBase
respectivement.
CWinAppEx::LoadWindowPlacement
Appelé par l’infrastructure lorsqu’il charge la taille et l’emplacement de la fenêtre de cadre principale à partir du Registre.
virtual BOOL LoadWindowPlacement(
CRect& rectNormalPosition,
int& nFlags,
int& nShowCmd);
Paramètres
rectNormalPosition
[out] Rectangle qui contient les coordonnées de la fenêtre de cadre principale lorsqu’elle est en position restaurée.
nFlags
[out] Indicateurs qui contrôlent la position de la fenêtre réduite et la façon dont le système d’exploitation bascule entre une fenêtre réduite et une fenêtre restaurée.
nShowCmd
[out] Entier qui spécifie l’état d’affichage de la fenêtre. Pour plus d’informations sur les valeurs possibles, consultez CWnd::ShowWindow
.
Valeur de retour
Différent de zéro si cela ; Sinon, 0.
Notes
Par défaut, MFC charge automatiquement la position et l’état précédents de la fenêtre frame principale au démarrage de l’application. Pour plus d’informations sur la façon dont ces informations sont stockées dans le Registre, consultez CWinAppEx::StoreWindowPlacement
.
Remplacez cette méthode si vous souhaitez charger des informations supplémentaires sur la fenêtre de trame principale.
CWinAppEx::m_bForceImageReset
Spécifie si l’infrastructure réinitialise toutes les images de barre d’outils lorsqu’elle recharge la fenêtre frame qui contient la barre d’outils.
BOOL m_bForceImageReset;
Notes
Le membre de données m_bForceImageReset
est une variable protégée.
CWinAppEx::OnAppContextHelp
L’infrastructure appelle cette méthode lorsque l’utilisateur demande de l’aide contextuelle pour la boîte de dialogue Personnalisation.
virtual void OnAppContextHelp(
CWnd* pWndControl,
const DWORD dwHelpIDArray[]);
Paramètres
pWndControl
[in] Pointeur vers un objet fenêtre pour lequel l’utilisateur a appelé l’aide de contexte.
dwHelpIDArray[]
[in] Valeur réservée.
Notes
Cette méthode est actuellement réservée pour une utilisation ultérieure. L’implémentation par défaut ne fait rien et elle n’est actuellement pas appelée par l’infrastructure.
CWinAppEx::OnClosingMainFrame
L’infrastructure appelle cette méthode lorsqu’une fenêtre frame traite WM_CLOSE
.
virtual void OnClosingMainFrame(CFrameImpl* pFrameImpl);
Paramètres
pFrameImpl
[in] Pointeur vers un objet CFrameImpl
.
Notes
L’implémentation par défaut de cette méthode enregistre l’état de pFrameImpl
.
CWinAppEx::OnViewDoubleClick
Appelle la commande définie par l’utilisateur associée à une vue lorsque l’utilisateur double-clique n’importe où dans cette vue.
virtual BOOL OnViewDoubleClick(
CWnd* pWnd,
int iViewId);
Paramètres
pWnd
[in] Pointeur vers un objet dérivé de CView
Classe.
iViewId
[in] ID d’affichage.
Valeur de retour
TRUE
si l’infrastructure trouve une commande ; sinon, FALSE
.
Notes
Pour prendre en charge le comportement personnalisé de la souris, vous devez appeler cette fonction lorsque vous traitez le message WM_LBUTTONDBLCLK
. Cette méthode exécute la commande associée à l’ID d’affichage fourni par iViewId
. Pour plus d’informations sur le comportement personnalisé de la souris, consultez Personnalisation du clavier et de la souris.
CWinAppEx::OnWorkspaceIdle
virtual BOOL OnWorkspaceIdle(CWnd*);
Paramètres
[in] CWnd*
\
Valeur de retour
Notes
CWinAppEx::PreLoadState
L’infrastructure appelle cette méthode immédiatement avant de charger l’état de l’application à partir du Registre.
virtual void PreLoadState();
Notes
Remplacez cette méthode si vous souhaitez effectuer un traitement immédiatement avant que l’infrastructure charge l’état de l’application.
CWinAppEx::PreSaveState
L’infrastructure appelle cette méthode immédiatement avant d’enregistrer l’état de l’application.
virtual void PreSaveState();
Notes
Remplacez cette méthode si vous souhaitez effectuer un traitement immédiatement avant que l’infrastructure enregistre l’état de l’application.
CWinAppEx::ReloadWindowPlacement
Recharge la taille et l’emplacement d’une fenêtre à partir du Registre.
virtual BOOL ReloadWindowPlacement(CFrameWnd* pFrame);
Paramètres
pFrame
[in] Pointeur vers une fenêtre frame.
Valeur de retour
Différent de zéro si la méthode a réussi ; 0 si la charge a échoué ou qu’il n’y a pas de données à charger.
Notes
Utilisez la fonction CWinAppEx::StoreWindowPlacement
pour écrire la taille et l’emplacement d’une fenêtre dans le Registre.
CWinAppEx::SaveCustomState
L’infrastructure appelle cette méthode après avoir enregistré l’état de l’application dans le Registre.
virtual void SaveCustomState();
Notes
Remplacez cette méthode si vous souhaitez effectuer un traitement après que l’application enregistre l’état dans le Registre. Par défaut, cette méthode ne fait rien.
CWinAppEx::SaveState
Écrit l’état de l’application dans le Registre Windows.
virtual BOOL SaveState(
LPCTSTR lpszSectionName = NULL,
CFrameImpl* pFrameImpl = NULL);
BOOL SaveState(
CMDIFrameWndEx* pFrame,
LPCTSTR lpszSectionName = NULL);
BOOL SaveState(
CFrameWndEx* pFrame,
LPCTSTR lpszSectionName = NULL);
BOOL SaveState(
COleIPFrameWndEx* pFrame,
LPCTSTR lpszSectionName = NULL);
Paramètres
lpszSectionName
[in] Chaîne qui contient le chemin d’accès relatif d’une clé de Registre.
pFrameImpl
[in] Pointeur vers un objet CFrameImpl
. Cette trame est enregistrée dans le Registre Windows.
pFrame
[in] Pointeur vers un objet de fenêtre frame. Cette trame est enregistrée dans le Registre Windows.
Valeur de retour
TRUE
en cas de réussite ; sinon FALSE
.
Notes
Cette méthode enregistre l’état de l’application et toutes les informations d’état pour la fenêtre frame fournie. Si vous ne fournissez pas de fenêtre frame, la méthode enregistre uniquement l’état de l’application. Les informations d’application incluent l’état de ClasseCMouseManager
, CContextMenuManager
Classe, CKeyboardManager
Classeet CUserToolsManager
Classe.
Le paramètre lpszSectionName
n’est pas le chemin absolu d’une entrée de Registre. Il s’agit d’un chemin relatif ajouté à la fin de la clé de Registre par défaut pour votre application. Pour obtenir ou définir la clé de Registre par défaut, utilisez les méthodes CWinAppEx::GetRegistryBase
et CWinAppEx::SetRegistryBase
respectivement.
CWinAppEx::SetRegistryBase
Définit le chemin d’accès du Registre par défaut pour l’application.
LPCTSTR SetRegistryBase(LPCTSTR lpszSectionName = NULL);
Paramètres
lpszSectionName
[in] Chaîne qui contient le chemin d’accès d’une clé de Registre.
Valeur de retour
Chaîne qui contient le chemin d’accès de l’emplacement du Registre par défaut.
Notes
Toutes les méthodes de la CWinAppEx
Classe qui accèdent au registre démarrent à un emplacement par défaut. Utilisez cette méthode pour modifier cet emplacement de Registre par défaut. Utilise CWinAppEx::GetRegistryBase
afin de récupérer l’emplacement du Registre par défaut.
CWinAppEx::ShowPopupMenu
Affiche un menu contextuel.
virtual BOOL ShowPopupMenu(
UINT uiMenuResId,
const CPoint& point,
CWnd* pWnd);
Paramètres
uiMenuResId
[in] ID de ressource de menu.
point
[in] Un CPoint
qui spécifie la position du menu dans les coordonnées de l’écran.
pWnd
[in] Pointeur vers la fenêtre qui possède le menu contextuel.
Valeur de retour
Différent de zéro si le menu contextuel s’affiche correctement ; Sinon, 0.
Notes
Cette méthode affiche le menu associé à uiMenuResId
.
Pour prendre en charge les menus contextuels, vous devez disposer d’un objet CContextMenuManager
. Si vous n’avez pas initialisé l’objet CContextMenuManager
, ShowPopupMenu
échoue.
CWinAppEx::StoreWindowPlacement
Appelé par l’infrastructure pour écrire la taille et l’emplacement de la fenêtre de trame principale dans le Registre.
virtual BOOL StoreWindowPlacement(
const CRect& rectNormalPosition,
int nFlags,
int nShowCmd);
Paramètres
nFlags
[in] Indicateurs qui contrôlent la position de la fenêtre réduite et la façon dont le système d’exploitation bascule entre une fenêtre réduite et une fenêtre restaurée.
nShowCmd
[in] Entier qui spécifie l’état d’affichage de la fenêtre. Pour plus d’informations sur les valeurs possibles, consultez CWnd::ShowWindow
.
rectNormalPosition
[in] Rectangle qui contient les coordonnées de la fenêtre cadre principale lorsqu’elle est dans l’état restauré.
Valeur de retour
Différent de zéro si cela ; Sinon, 0.
Notes
Par défaut, MFC enregistre automatiquement la position et l’état de la fenêtre frame principale avant la sortie de l’application. Ces informations sont stockées dans le Registre Windows sous la clé WindowPlacement dans l’emplacement de Registre par défaut de votre application. Pour plus d’informations sur l’emplacement de Registre par défaut de votre application, consultez CWinAppEx::GetRegistryBase
.
Remplacez cette méthode si vous souhaitez stocker des informations supplémentaires sur la fenêtre de cadre principale.
CWinAppEx::WriteBinary
Écrit des données binaires dans le Registre.
BOOL WriteBinary(
LPCTSTR lpszEntry,
LPBYTE pData,
UINT nBytes);
Paramètres
lpszEntry
[in] Chaîne qui contient le nom d’une clé de Registre.
pData
[in] Données à stocker.
nBytes
[in] Taille de pData
en octets.
Valeur de retour
TRUE
si cette méthode réussit ; sinon, FALSE
.
Notes
Le paramètre lpszEntry
est le nom d’une entrée de Registre située sous la clé de Registre par défaut pour votre application. Pour obtenir ou définir la clé de Registre par défaut, utilisez les méthodes CWinAppEx::GetRegistryBase
et CWinAppEx::SetRegistryBase
respectivement.
Si la clé spécifiée par lpszEntry
n’existe pas, cette méthode la crée.
CWinAppEx::WriteInt
Écrit des données numériques dans le Registre.
BOOL WriteInt(
LPCTSTR lpszEntry,
int nValue);
Paramètres
lpszEntry
[in] Chaîne qui contient le nom d’une clé de Registre.
nValue
[in] Données à stocker.
Valeur de retour
TRUE
si cette méthode réussit ; sinon, FALSE
.
Notes
Le paramètre lpszEntry
est le nom d’une entrée de Registre située sous la clé de Registre par défaut pour votre application. Pour obtenir ou définir la clé de Registre par défaut, utilisez les méthodes CWinAppEx::GetRegistryBase
et CWinAppEx::SetRegistryBase
respectivement.
Si la clé spécifiée par lpszEntry
n’existe pas, cette méthode la crée.
CWinAppEx::WriteObject
Écrit les données dérivées de la CObject
Classe dans le Registre.
BOOL WriteObject(
LPCTSTR lpszEntry,
CObject& obj);
Paramètres
lpszEntry
[in] Chaîne qui contient la valeur à définir.
obj
[in] Référence aux données CObject
que la méthode stockera.
Valeur de retour
TRUE
si cette méthode réussit ; sinon, FALSE
.
Notes
Cette méthode écrit les données obj
dans la valeur spécifiée sous la clé de Registre par défaut. Utilisez CWinAppEx::GetRegistryBase
pour déterminer la clé de Registre actuelle.
CWinAppEx::WriteSectionBinary
Écrit des données binaires dans une valeur dans le Registre.
BOOL WriteSectionBinary(
LPCTSTR lpszSubSection,
LPCTSTR lpszEntry,
LPBYTE pData,
UINT nBytes);
Paramètres
lpszSubSection
[in] Chaîne qui contient le nom d’une clé de Registre
lpszEntry
[in] Chaîne qui contient la valeur à définir.
pData
[in] Données à écrire dans le Registre.
nBytes
[in] Taille de pData
en octets.
Valeur de retour
TRUE
si cette méthode réussit ; sinon, FALSE
.
Notes
Le paramètre lpszSubSection
n’est pas le chemin absolu d’une entrée de Registre. Il s’agit d’un chemin relatif ajouté à la fin de la clé de Registre par défaut pour votre application. Pour obtenir ou définir la clé de Registre par défaut, utilisez les méthodes CWinAppEx::GetRegistryBase
et CWinAppEx::SetRegistryBase
respectivement.
Si la clé spécifiée par lpszEntry
n’existe pas, cette méthode la crée.
CWinAppEx::WriteSectionInt
Écrit des données numériques dans le Registre.
BOOL WriteSectionInt(
LPCTSTR lpszSubSection,
LPCTSTR lpszEntry,
int nValue);
Paramètres
lpszSubSection
[in] Chaîne qui contient le chemin d’accès relatif d’une clé de Registre.
lpszEntry
[in] Chaîne qui contient la valeur à définir.
nValue
[in] Données à écrire dans le Registre.
Valeur de retour
TRUE
si cette méthode réussit ; sinon, FALSE
.
Notes
Le paramètre lpszSubSection
n’est pas un chemin absolu pour une entrée de Registre. Il s’agit d’un chemin relatif ajouté à la clé de Registre par défaut pour votre application. Pour obtenir ou définir la clé de Registre par défaut, utilisez les méthodes CWinAppEx::GetRegistryBase
et CWinAppEx::SetRegistryBase
respectivement.
Si la clé spécifiée par lpszEntry
n’existe pas, cette méthode la crée.
CWinAppEx::WriteSectionObject
Écrit les données dérivées de la CObject
Classe dans une valeur de Registre spécifique.
BOOL WriteSectionObject(
LPCTSTR lpszSubSection,
LPCTSTR lpszEntry,
CObject& obj);
Paramètres
lpszSubSection
[in] Chaîne qui contient le nom d’une clé de Registre.
lpszEntry
[in] Chaîne qui contient le nom de la valeur à définir.
obj
[in] Données à stocker.
Valeur de retour
TRUE
si cette méthode réussit ; sinon, FALSE
.
Notes
Le paramètre lpszSubSection
n’est pas un chemin absolu pour une entrée de Registre. Il s’agit d’un chemin relatif ajouté à la fin de la clé de Registre par défaut pour votre application. Pour obtenir ou définir la clé de Registre par défaut, utilisez les méthodes CWinAppEx::GetRegistryBase
et CWinAppEx::SetRegistryBase
, respectivement.
Si la valeur spécifiée par lpszEntry
n’existe pas sous la clé de Registre spécifiée par lpszSubSection
, cette méthode crée cette valeur.
CWinAppEx::WriteSectionString
Écrit des données de chaîne dans une valeur dans le Registre.
BOOL WriteSectionString(
LPCTSTR lpszSubSection,
LPCTSTR lpszEntry,
LPCTSTR lpszValue);
Paramètres
lpszSubSection
[in] Chaîne qui contient le nom d’une clé de Registre.
lpszEntry
[in] Chaîne qui contient la valeur à définir.
lpszValue
[in] Données de chaîne à écrire dans le Registre.
Valeur de retour
TRUE
si cette méthode réussit ; sinon, FALSE
.
Notes
Le paramètre lpszSubSection
n’est pas un chemin absolu pour une entrée de Registre. Il s’agit d’un chemin relatif ajouté à la fin de la clé de Registre par défaut pour votre application. Pour obtenir ou définir la clé de Registre par défaut, utilisez les méthodes CWinAppEx::GetRegistryBase
et CWinAppEx::SetRegistryBase
, respectivement.
Si la valeur spécifiée par lpszEntry
n’existe pas sous lpszSubSection
, cette méthode la crée.
CWinAppEx::WriteString
Écrit des données de chaîne dans le Registre.
BOOL WriteString(
LPCTSTR lpszEntry,
LPCTSTR lpszValue);
Paramètres
lpszEntry
[in] Chaîne qui contient le nom d’une clé de Registre.
lpszValue
[in] Données à stocker.
Valeur de retour
TRUE
si cette méthode réussit ; sinon, FALSE
.
Notes
Le paramètre lpszEntry
est le nom d’une entrée de Registre située sous la clé de Registre par défaut pour votre application. Pour obtenir ou définir la clé de Registre par défaut, utilisez les méthodes CWinAppEx::GetRegistryBase
et CWinAppEx::SetRegistryBase
respectivement.
Si la clé spécifiée par lspzEntry
n’existe pas, cette méthode la crée.
Voir aussi
Graphique hiérarchique
Classes
CWinApp
Classe
CMouseManager
Classe
CContextMenuManager
Classe
CKeyboardManager
Classe
CUserToolsManager
Classe