CWinAppEx klasse

CWinAppEx de toepassingsstatus afhandelt, de status opslaat in het register, de status van het register laadt, toepassingsbeheerders initialiseert en koppelingen naar dezelfde toepassingsbeheerders biedt.

Zie de broncode in de mfc map van uw Visual Studio-installatie voor meer informatie. Bijvoorbeeld %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Syntaxis

class CWinAppEx : public CWinApp

Leden

Openbare constructors

Naam	Beschrijving
CWinAppEx::CWinAppEx	Maakt een CWinAppEx-object.

Openbare methoden

Naam	Beschrijving
CWinAppEx::CleanState	Hiermee verwijdert u informatie over de toepassing uit het Windows-register.
CWinAppEx::EnableLoadWindowPlacement	Hiermee geeft u op of de toepassing de oorspronkelijke grootte en locatie van het hoofdframevenster uit het register laadt.
CWinAppEx::EnableTearOffMenus	Hiermee schakelt u losloopmenu's voor de toepassing in.
CWinAppEx::EnableUserTools	Hiermee kan de gebruiker aangepaste menuopdrachten maken in de toepassing.
CWinAppEx::ExitInstance	Aangeroepen door het framework vanuit de Run lidfunctie om dit exemplaar van de toepassing af te sluiten. (Overschrijft CWinApp::ExitInstance.)
CWinAppEx::GetBinary	Hiermee worden binaire gegevens gelezen die zijn gekoppeld aan de opgegeven registerwaarde.
CWinAppEx::GetContextMenuManager	Retourneert een aanwijzer naar het globale CContextMenuManager-object.
CWinAppEx::GetDataVersion
CWinAppEx::GetDataVersionMajor	Retourneert de primaire versie van de toepassing die is opgeslagen in het Windows-register.
CWinAppEx::GetDataVersionMinor	Retourneert de secundaire versie van de toepassing die is opgeslagen in het Windows-register.
CWinAppEx::GetInt	Hiermee worden numerieke gegevens gelezen die zijn gekoppeld aan de opgegeven waarde uit het register.
CWinAppEx::GetKeyboardManager	Retourneert een aanwijzer naar het globale CKeyboardManager-object.
CWinAppEx::GetMouseManager	Retourneert een aanwijzer naar het globale CMouseManager-object.
CWinAppEx::GetObject	Leest CObject-afgeleide gegevens die zijn gekoppeld aan de opgegeven waarde uit het register.
CWinAppEx::GetRegSectionPath	Retourneert een tekenreeks die het pad van een registersleutel is. Dit pad voegt het opgegeven relatieve pad samen met het toepassingspad.
CWinAppEx::GetRegistryBase	Retourneert het registerpad voor de toepassing.
CWinAppEx::GetSectionBinary	Hiermee worden binaire gegevens gelezen die zijn gekoppeld aan de opgegeven sleutel en waarde uit het register.
CWinAppEx::GetSectionInt	Leest numerieke gegevens uit het register dat is gekoppeld aan de opgegeven sleutel en waarde.
CWinAppEx::GetSectionObject	Leest CObject gegevens die zijn gekoppeld aan de opgegeven sleutel en waarde uit het register.
CWinAppEx::GetSectionString	Leest tekenreeksgegevens die zijn gekoppeld aan de opgegeven sleutel en waarde uit het register.
CWinAppEx::GetShellManager	Retourneert een aanwijzer naar het globale CShellManager-object.
CWinAppEx::GetString	Leest tekenreeksgegevens die zijn gekoppeld aan de opgegeven waarde uit het register.
CWinAppEx::GetTooltipManager	Retourneert een aanwijzer naar het globale CTooltipManager-object.
CWinAppEx::GetUserToolsManager	Retourneert een aanwijzer naar het globale CUserToolsManager-object.
CWinAppEx::InitContextMenuManager	Initialiseert het CContextMenuManager-object.
CWinAppEx::InitKeyboardManager	Initialiseert het CKeyboardManager-object.
CWinAppEx::InitMouseManager	Initialiseert het CMouseManager-object.
CWinAppEx::InitShellManager	Initialiseert de CShellManager-klasse
CWinAppEx::InitTooltipManager	Initialiseert de CTooltipManager-klasse.
CWinAppEx::IsResourceSmartUpdate
CWinAppEx::IsStateExists	Geeft aan of de opgegeven sleutel zich in het register bevindt.
CWinAppEx::LoadState	Laadt de toepassingsstatus uit het register.
CWinAppEx::OnAppContextHelp	Wordt aangeroepen door het framework wanneer de gebruiker contextondersteuning aanvraagt voor het dialoogvenster Aanpassing.
CWinAppEx::OnViewDoubleClick	Roept de door de gebruiker gedefinieerde opdracht aan wanneer de gebruiker ergens in de toepassing dubbelklikt.
CWinAppEx::OnWorkspaceIdle
CWinAppEx::SaveState	Hiermee schrijft u de status van het toepassingsframework naar het Windows-register.
CWinAppEx::SetRegistryBase	Hiermee stelt u het pad van de standaardregistersleutel in. Deze sleutel fungeert als hoofdmap voor alle volgende registeroproepen.
CWinAppEx::ShowPopupMenu	Hiermee wordt een pop-upmenu weergegeven.
CWinAppEx::WriteBinary	Schrijft de binaire gegevens naar de opgegeven registerwaarde.
CWinAppEx::WriteInt	Schrijft de numerieke gegevens naar de opgegeven registerwaarde.
CWinAppEx::WriteObject	Hiermee schrijft u gegevens die zijn afgeleid van de CObject Klasse naar de opgegeven registerwaarde.
CWinAppEx::WriteSectionBinary	Schrijft de binaire gegevens naar een waarde van de opgegeven registersleutel.
CWinAppEx::WriteSectionInt	Schrijft de numerieke gegevens naar een waarde van de opgegeven registersleutel.
CWinAppEx::WriteSectionObject	Schrijft gegevens die zijn afgeleid van de CObject-klasse naar een waarde van de opgegeven registersleutel.
CWinAppEx::WriteSectionString	Hiermee schrijft u de tekenreeksgegevens naar een waarde van de opgegeven registersleutel.
CWinAppEx::WriteString	Hiermee schrijft u de tekenreeksgegevens naar de opgegeven registerwaarde.

Beveiligde methoden

Naam	Beschrijving
CWinAppEx::LoadCustomState	Aangeroepen door het framework wanneer de toepassingsstatus is geladen.
CWinAppEx::LoadWindowPlacement	Aangeroepen door het framework wanneer de grootte en locatie van uw toepassing vanuit het register worden geladen. De geladen gegevens bevatten de grootte en locatie van het hoofdframe op het moment dat uw toepassing voor het laatst is gesloten.
CWinAppEx::OnClosingMainFrame	Aangeroepen door het framework wanneer een hoofdframevenster wordt verwerkt WM_CLOSE.
CWinAppEx::PreLoadState	Wordt aangeroepen door het framework direct voordat de toepassingsstatus wordt geladen.
CWinAppEx::PreSaveState	Wordt aangeroepen door het framework direct voordat de toepassingsstatus wordt opgeslagen.
CWinAppEx::ReloadWindowPlacement	Laadt de grootte en locatie van het opgegeven venster opnieuw vanuit het register
CWinAppEx::SaveCustomState	Aangeroepen door het framework nadat de toepassingsstatus naar het register is geschreven.
CWinAppEx::StoreWindowPlacement	Aangeroepen door het framework om de grootte en locatie van het hoofdframe naar het register te schrijven.

Gegevensleden

Naam	Beschrijving
CWinAppEx::m_bForceImageReset	Hiermee geeft u op of het framework alle werkbalkafbeeldingen opnieuw instelt wanneer het framevenster met de werkbalk wordt geladen.

Opmerkingen

Veel van de functionaliteit van het MFC-framework is afhankelijk van de CWinAppEx klasse. U kunt de CWinAppEx-klasse op twee manieren opnemen in uw toepassing:

• Maak een CWinAppEx-klasse in de hoofdthread.

• De hoofdtoepassingsklasse afleiden van CWinAppEx.

Nadat u CWinAppEx hebt opgenomen in uw toepassing, kunt u een van de toepassingsbeheerders initialiseren. Voordat u een toepassingsbeheerder gebruikt, moet u deze initialiseren door de juiste initialisatiemethode aan te roepen. Als u een aanwijzer naar een specifieke manager wilt ophalen, roept u de bijbehorende get-methode aan. De CWinAppEx klasse beheert de volgende toepassingsbeheerders: CMouseManager Class, CContextMenuManager Class, CKeyboardManager Class, CUserToolsManager Classen CMenuTearOffManager Class.

Overnamehiërarchie

CObject

CCmdTarget

CWinThread

CWinApp

CWinAppEx

Eisen

koptekst:afxwinappex.h

CWinAppEx::CleanState

Hiermee verwijdert u alle informatie over de toepassing uit het Windows-register.

virtual BOOL CleanState(LPCTSTR lpszSectionName=NULL);

Parameters

lpszSectionName
[in] Een tekenreeks die een pad van een registersleutel bevat.

Retourwaarde

Niet-nul als de methode is geslaagd; anders 0.

Opmerkingen

Met deze methode worden toepassingsgegevens gewist uit een specifieke sectie van het register. U kunt de sectie opgeven die moet worden gewist met behulp van de parameter lpszSectionName. Als lpszSectionName is NULL, gebruikt deze methode het standaardregisterpad dat is opgeslagen in het CWinAppEx-object. Gebruik CWinAppEx::GetRegistryBaseom het standaardregisterpad op te halen.

CWinAppEx::CWinAppEx

Maakt een CWinAppEx-object.

CWinAppEx(BOOL bResourceSmartUpdate = FALSE);

Parameters

bResourceSmartUpdate
[in] Een Booleaanse parameter die aangeeft of het werkruimteobject resource-updates moet detecteren en verwerken.

Opmerkingen

De CWinAppEx-klasse heeft initialisatiemethoden, biedt functionaliteit voor het opslaan en laden van toepassingsgegevens in het register en beheert globale toepassingsinstellingen. Hiermee kunt u ook globale managers zoals de CKeyboardManager Class en de CUserToolsManager Classgebruiken. Elke toepassing kan slechts één exemplaar van de CWinAppEx-klasse hebben.

CWinAppEx::EnableLoadWindowPlacement

Hiermee geeft u op of de toepassing de oorspronkelijke grootte en locatie van het hoofdframevenster uit het register laadt.

void EnableLoadWindowPlacement(BOOL bEnable = TRUE);

Parameters

bEnable
[in] Hiermee geeft u op of de toepassing de oorspronkelijke grootte en locatie van het hoofdframevenster uit het register laadt.

Opmerkingen

Standaard wordt de grootte en locatie van het hoofdframe samen met andere toepassingsinstellingen uit het register geladen. Dit gebeurt tijdens CWinAppEx::LoadState. Als u de eerste plaatsing van het venster niet vanuit het register wilt laden, roept u deze methode aan met bEnable ingesteld op FALSE.

CWinAppEx::EnableTearOffMenus

Hiermee maakt en initialiseert u een CMenuTearOffManager-object.

BOOL EnableTearOffMenus(
    LPCTSTR lpszRegEntry,
    const UINT uiCmdFirst,
    const UINT uiCmdLast);

Parameters

lpszRegEntry
[in] Een tekenreeks die het pad van een registersleutel bevat. De toepassing gebruikt deze registersleutel om informatie op te slaan voor de menu's die worden losgemaakt.

uiCmdFirst
[in] De eerste menu-id.

uiCmdLast
[in] De laatste loslaat menu-id.

Retourwaarde

TRUE als de CMenuTearOffManager is gemaakt en geïnitialiseerd; FALSE als er een fout optreedt of als de CMenuTearOffManager al bestaat.

Opmerkingen

Gebruik deze functie om menu's in te schakelen in uw toepassing. U moet deze functie aanroepen vanuit InitInstance.

CWinAppEx::EnableUserTools

Hiermee kan de gebruiker aangepaste menuopdrachten maken die toetsaanslagen in uw toepassing verminderen. Met deze methode maakt u een CUserToolsManager-object.

BOOL EnableUserTools(
    const UINT uiCmdToolsDummy,
    const UINT uiCmdFirst,
    const UINT uiCmdLast,
    CRuntimeClass* pToolRTC = RUNTIME_CLASS(CUserTool),
    UINT uArgMenuID = 0,
    UINT uInitDirMenuID = 0);

Parameters

uiCmdToolsDummy
[in] Een geheel getal zonder teken dat door het framework wordt gebruikt als tijdelijke aanduiding voor de opdracht-id van het menu Gebruikershulpprogramma's.

uiCmdFirst
[in] De opdracht-id voor de eerste opdracht voor het hulpprogramma van de gebruiker.

uiCmdLast
[in] De opdracht-id voor de laatste opdracht voor het hulpprogramma van de gebruiker.

pToolRTC
[in] Een klasse die door het CUserToolsManager-object wordt gebruikt om nieuwe gebruikershulpprogramma's te maken.

uArgMenuID
[in] De menu-id van het argument.

uInitDirMenuID
[in] De menu-id voor de eerste map van het hulpprogramma.

Retourwaarde

TRUE als de methode een CUserToolsManager-object maakt en initialiseert; FALSE als de methode mislukt of als er al een CUserToolsManager object bestaat.

Opmerkingen

Wanneer u door de gebruiker gedefinieerde hulpprogramma's inschakelt, ondersteunt het framework automatisch een dynamisch menu dat kan worden uitgebreid tijdens het aanpassen. Het framework koppelt elk nieuw item aan een externe opdracht. Het framework roept deze opdrachten aan wanneer de gebruiker het juiste item selecteert in het menu Extra.

Telkens wanneer de gebruiker een nieuw item toevoegt, maakt het framework een nieuw object. Het klassetype voor het nieuwe object wordt gedefinieerd door pToolRTC. Het pToolRTC klassetype moet worden afgeleid van de CUserTool Klasse.

Zie Door de gebruiker gedefinieerde hulpprogramma'svoor meer informatie over gebruikershulpprogramma's en hoe u deze kunt opnemen in uw toepassing.

CWinAppEx::ExitInstance

virtual int ExitInstance();

Retourwaarde

Opmerkingen

CWinAppEx::GetBinary

Leest binaire gegevens uit een opgegeven registersleutel.

BOOL GetBinary(
    LPCTSTR lpszEntry,
    LPBYTE* ppData,
    UINT* pBytes);

Parameters

lpszEntry
[in] Een tekenreeks die de naam van een registersleutel bevat.

ppData
[uit] Een aanwijzer naar de buffer die de methode vult met de binaire gegevens.

pBytes
[uit] Een aanwijzer naar een niet-ondertekend geheel getal dat door de methode wordt gebruikt om het aantal gelezen bytes te schrijven.

Retourwaarde

TRUE indien geslaagd; FALSE anders.

Opmerkingen

Met deze methode worden binaire gegevens gelezen die naar het register zijn geschreven. Als u gegevens naar het register wilt schrijven, gebruikt u de methoden CWinAppEx::WriteBinary en CWinAppEx::WriteSectionBinary.

De parameter lpszEntry is de naam van een registervermelding die zich onder de standaardregistersleutel voor uw toepassing bevindt. Als u de standaardregistersleutel wilt ophalen of instellen, gebruikt u respectievelijk de methoden CWinAppEx::GetRegistryBase en CWinAppEx::SetRegistryBase.

CWinAppEx::GetContextMenuManager

Retourneert een aanwijzer naar het globale CContextMenuManager-object.

CContextMenuManager* GetContextMenuManager();

Retourwaarde

Een aanwijzer naar het globale CContextMenuManager-object.

Opmerkingen

Als het CContextMenuManager object niet is geïnitialiseerd, roept deze functie CWinAppEx::InitContextMenuManager aan voordat er een aanwijzer wordt geretourneerd.

CWinAppEx::GetDataVersion

int GetDataVersion() const;

Retourwaarde

Opmerkingen

CWinAppEx::GetDataVersionMajor

Retourneert de primaire versie van de toepassing die is opgeslagen in het Windows-register wanneer u CWinAppEx::SaveStateaanroept.

int GetDataVersionMajor() const;

Retourwaarde

Een geheel getal dat het primaire versienummer bevat.

CWinAppEx::GetDataVersionMinor

Retourneert de secundaire versie van de toepassing die is opgeslagen in het Windows-register wanneer u CWinAppEx::SaveStateaanroept.

int GetDataVersionMinor() const;

Retourwaarde

Een geheel getal dat het secundaire versienummer bevat.

CWinAppEx::GetInt

Leest gehele getallen van een opgegeven registersleutel.

int GetInt(
    LPCTSTR lpszEntry,
    int nDefault = 0);

Parameters

lpszEntry
[in] Een tekenreeks die de naam van een registervermelding bevat.

nDefault
[in] De standaardwaarde die door de methode wordt geretourneerd als de opgegeven registervermelding niet bestaat.

Retourwaarde

De registergegevens als de methode is geslaagd; anders nDefault.

Opmerkingen

Met deze methode worden gehele getallen uit het register gelezen. Als er geen gehele getallen zijn gekoppeld aan de registersleutel die wordt aangegeven door lpszEntry, retourneert deze methode nDefault. Als u gegevens naar het register wilt schrijven, gebruikt u de methoden CWinAppEx::WriteSectionInt en CWinAppEx::WriteInt.

De parameter lpszEntry is de naam van een registervermelding die zich onder de standaardregistersleutel voor uw toepassing bevindt. Als u de standaardregistersleutel wilt ophalen of instellen, gebruikt u respectievelijk de methoden CWinAppEx::GetRegistryBase en CWinAppEx::SetRegistryBase.

CWinAppEx::GetKeyboardManager

Retourneert een aanwijzer naar het globale CKeyboardManager-object.

CKeyboardManager* GetKeyboardManager();

Retourwaarde

Een aanwijzer naar het globale CKeyboardManager-object.

Opmerkingen

Als het toetsenbordbeheer niet is geïnitialiseerd, roept deze functie CWinAppEx::InitKeyboardManager aan voordat er een aanwijzer wordt geretourneerd.

CWinAppEx::GetMouseManager

Retourneert een aanwijzer naar het globale CMouseManager-object.

CMouseManager* GetMouseManager();

Retourwaarde

Een aanwijzer naar het globale CMouseManager-object.

Opmerkingen

Als de muisbeheerder niet is geïnitialiseerd, roept deze functie CWinAppEx::InitMouseManager aan voordat er een aanwijzer wordt geretourneerd.

CWinAppEx::GetObject

Leest CObject-gedegradeerde gegevens uit het register.

BOOL GetObject(
    LPCTSTR lpszEntry,
    CObject& obj);

Parameters

lpszEntry
[in] Een tekenreeks die het relatieve pad van een registervermelding bevat.

obj
[uit] Een verwijzing naar een CObject. De methode gebruikt deze verwijzing om de registergegevens op te slaan.

Retourwaarde

Niet-nul als de methode is geslaagd; anders 0.

Opmerkingen

Met deze methode worden gegevens uit het register gelezen die zijn afgeleid van CObject. Als u CObject gegevens naar het register wilt schrijven, gebruikt u CWinAppEx::WriteObject of CWinAppEx::WriteSectionObject.

De parameter lpszEntry is de naam van een registervermelding die zich onder de standaardregistersleutel voor uw toepassing bevindt. Als u de standaardregistersleutel wilt ophalen of instellen, gebruikt u respectievelijk de methoden CWinAppEx::GetRegistryBase en CWinAppEx::SetRegistryBase.

CWinAppEx::GetRegistryBase

Hiermee wordt het standaardregisterpad voor de toepassing opgehaald.

LPCTSTR GetRegistryBase();

Retourwaarde

Een tekenreeks die het pad van de standaardregisterlocatie bevat.

Opmerkingen

Alle methoden van de CWinAppEx Class die toegang hebben tot het register, beginnen op een standaardlocatie. Gebruik deze methode om een pad op te halen van de standaardregisterlocatie. Gebruik CWinAppEx::SetRegistryBase om de standaardregisterlocatie te wijzigen.

CWinAppEx::GetRegSectionPath

Hiermee maakt en retourneert u het absolute pad van een registersleutel.

CString GetRegSectionPath(LPCTSTR szSectionAdd = _T(""));

Parameters

szSectionAdd
[in] Een tekenreeks die het relatieve pad van een registersleutel bevat.

Retourwaarde

Een CString die het absolute pad van een registersleutel bevat.

Opmerkingen

Met deze methode definieert u het absolute pad van de registersleutel door het relatieve pad in szSectionAdd toe te voegen aan de standaardregisterlocatie voor uw toepassing. Gebruik de methode CWinAppEx::GetRegistryBaseom de standaardregistersleutel op te halen.

CWinAppEx::GetSectionBinary

Hiermee worden binaire gegevens uit het register gelezen.

BOOL GetSectionBinary(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    LPBYTE* ppData,
    UINT* pBytes);

Parameters

lpszSubSection
[in] Een tekenreeks die het relatieve pad van een registersleutel bevat.

lpszEntry
[in] Een tekenreeks die de waarde bevat die moet worden gelezen.

ppData
[uit] Een aanwijzer naar de buffer waar de methode de gegevens opslaat.

pBytes
[uit] Een aanwijzer naar een geheel getal zonder teken. De methode schrijft de grootte van ppData naar deze parameter.

Retourwaarde

TRUE indien geslaagd; anders FALSE.

Opmerkingen

Met deze methode worden binaire gegevens gelezen die naar het register worden geschreven met behulp van de methoden CWinAppEx::WriteBinary en CWinAppEx::WriteSectionBinary.

De parameter lpszSubSection is geen absoluut pad voor een registervermelding. Het is een relatief pad dat wordt toegevoegd aan het einde van de standaardregistersleutel voor uw toepassing. Als u de standaardregistersleutel wilt ophalen of instellen, gebruikt u respectievelijk de methoden CWinAppEx::GetRegistryBase en CWinAppEx::SetRegistryBase.

CWinAppEx::GetSectionInt

Leest gehele getallen uit het register.

int GetSectionInt(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    int nDefault = 0);

Parameters

lpszSubSection
[in] Een tekenreeks die het relatieve pad van een registersleutel bevat.

lpszEntry
[in] Een tekenreeks die de waarde bevat die moet worden gelezen.

nDefault
[in] De standaardwaarde die moet worden geretourneerd als de opgegeven waarde niet bestaat.

Retourwaarde

De gehele getallen die zijn opgeslagen in de opgegeven registerwaarde; nDefault als de gegevens niet bestaan.

Opmerkingen

Gebruik de methoden CWinAppEx::WriteInt en CWinAppEx::WriteSectionInt om gehele getallen naar het register te schrijven.

De parameter lpszSubSection is geen absoluut pad van een registervermelding. Het is een relatief pad dat wordt toegevoegd aan het einde van de standaardregistersleutel voor uw toepassing. Als u de standaardregistersleutel wilt ophalen of instellen, gebruikt u respectievelijk de methoden CWinAppEx::GetRegistryBase en CWinAppEx::SetRegistryBase.

CWinAppEx::GetSectionObject

Leest CObject registergegevens uit het register.

BOOL GetSectionObject(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    CObject& obj);

Parameters

lpszSubSection
[in] Een tekenreeks die het relatieve pad van een registersleutel bevat.

lpszEntry
[in] Een tekenreeks die de waarde bevat die moet worden gelezen.

obj
[uit] Een verwijzing naar een CObject. De methode gebruikt deze CObject om de registergegevens op te slaan.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

Met deze methode worden gegevens uit het register gelezen. De gegevens die worden gelezen, zijn CObject gegevens of gegevens voor een klasse die is afgeleid van CObject. Als u CObject gegevens naar het register wilt schrijven, gebruikt u CWinAppEx::WriteObject of CWinAppEx::WriteSectionObject.

De parameter lpszSubSection is geen absoluut pad voor een registervermelding. Het is een relatief pad dat wordt toegevoegd aan het einde van de standaardregistersleutel voor uw toepassing. Als u de standaardregistersleutel wilt ophalen of instellen, gebruikt u respectievelijk de methoden CWinAppEx::GetRegistryBase en CWinAppEx::SetRegistryBase.

CWinAppEx::GetSectionString

Leest tekenreeksgegevens uit het register.

CString GetSectionString(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    LPCTSTR lpszDefault = _T(""));

Parameters

lpszSubSection
[in] Een tekenreeks die het relatieve pad van een registersleutel bevat.

lpszEntry
[in] Een tekenreeks die de waarde bevat die moet worden gelezen.

lpszDefault
[in] De standaardwaarde die moet worden geretourneerd als de opgegeven waarde niet bestaat.

Retourwaarde

De tekenreeksgegevens die zijn opgeslagen in de opgegeven registerwaarde als de gegevens bestaan; anders lpszDefault.

Opmerkingen

Met deze methode worden tekenreeksgegevens gelezen die naar het register zijn geschreven. Gebruik CWinAppEx::WriteString en CWinAppEx::WriteSectionString om tekenreeksgegevens naar het register te schrijven.

De parameter lpszSubSection is geen absoluut pad voor een registervermelding. Het is een relatief pad dat wordt toegevoegd aan het einde van de standaardregistersleutel voor uw toepassing. Als u de standaardregistersleutel wilt ophalen of instellen, gebruikt u respectievelijk de methoden CWinAppEx::GetRegistryBase en CWinAppEx::SetRegistryBase.

CWinAppEx::GetShellManager

Retourneert een aanwijzer naar het globale CShellManager-object.

CShellManager* GetShellManager();

Retourwaarde

Een aanwijzer naar het globale CShellManager-object.

Opmerkingen

Als het CShellManager object niet is geïnitialiseerd, roept deze functie CWinAppEx::InitShellManager aan voordat er een aanwijzer wordt geretourneerd.

CWinAppEx::GetString

Leest tekenreeksgegevens uit een opgegeven registersleutel.

CString GetString(
    LPCTSTR lpszEntry,
    LPCTSTR lpzDefault= _T(""));

Parameters

lpszEntry
[in] Een tekenreeks die de naam van een registersleutel bevat

lpzDefault
[in] De standaardwaarde die door de methode wordt geretourneerd als de opgegeven registervermelding niet bestaat.

Retourwaarde

De tekenreeksgegevens die zijn opgeslagen in het register, indien geslaagd; lpszDefault anders.

Opmerkingen

Met deze methode worden tekenreeksgegevens gelezen die naar het register zijn geschreven. Als u gegevens naar het register wilt schrijven, gebruikt u de methoden CWinAppEx::WriteString of CWinAppEx::WriteSectionString.

De parameter lpszEntry is de naam van een registervermelding die zich onder de standaardregistersleutel voor uw toepassing bevindt. Als u de standaardregistersleutel wilt ophalen of instellen, gebruikt u respectievelijk de methoden CWinAppEx::GetRegistryBase en CWinAppEx::SetRegistryBase.

CWinAppEx::GetTooltipManager

Retourneert een aanwijzer naar het globale CTooltipManager-object.

CTooltipManager* GetTooltipManager();

Retourwaarde

Een aanwijzer naar het globale CTooltipManager-object.

Opmerkingen

Als het CTooltipManager object niet is geïnitialiseerd, roept deze functie CWinAppEx::InitTooltipManager aan voordat er een aanwijzer wordt geretourneerd.

CWinAppEx::GetUserToolsManager

Retourneert een aanwijzer naar het globale CUserToolsManager-object.

CUserToolsManager* GetUserToolsManager();

Retourwaarde

Een aanwijzer naar het globale CUserToolsManager-object; NULL als het beheer van gebruikershulpprogramma's niet is ingeschakeld voor de toepassing.

Opmerkingen

Voordat u een aanwijzer naar het CUserToolsManager-object ophaalt, moet u de manager initialiseren door CWinAppEx::EnableUserToolsaan te roepen.

CWinAppEx::InitContextMenuManager

Initialiseert het CContextMenuManager-object.

BOOL InitContextMenuManager();

Retourwaarde

Niet-nul als de methode het CContextMenuManager-object maakt; 0 als het CContextMenuManager object al bestaat.

Opmerkingen

Als u CWinAppEx::GetContextMenuManageraanroept, roept de standaard implementatie van die methode InitContextMenuManageraan.

Als uw toepassing al een contextmenubeheer heeft en u InitContextMenuManageraanroept, heeft uw toepassing een ASSERT fout. Daarom moet u InitContextMenuManager niet aanroepen als u rechtstreeks een CContextMenuManager-object maakt. Als u geen aangepaste CContextMenuManagergebruikt, moet u GetContextMenuManager gebruiken om een CContextMenuManager-object te maken.

CWinAppEx::InitKeyboardManager

Initialiseert het CKeyboardManager-object.

BOOL InitKeyboardManager();

Retourwaarde

Niet-nul als de methode het CKeyboardManager-object maakt; 0 als het CKeyboardManager object al bestaat.

Opmerkingen

Als u CWinAppEx::GetKeyboardManageraanroept, roept de standaard implementatie van die methode InitKeyboardManageraan.

Als uw toepassing al een toetsenbordbeheerder heeft en u InitKeyboardManageraanroept, heeft uw toepassing een ASSERT fout. Daarom moet u InitKeyboardManager niet aanroepen als u rechtstreeks een CKeyboardManager-object maakt. Als u geen aangepaste CKeyboardManagergebruikt, moet u GetKeyboardManager gebruiken om een CKeyboardManager-object te maken.

CWinAppEx::InitMouseManager

Initialiseert het CMouseManager-object.

BOOL InitMouseManager();

Retourwaarde

Niet-nul als de methode het CMouseManager-object maakt; 0 als het CMouseManager object al bestaat.

Opmerkingen

Als u CWinAppEx::GetMouseManageraanroept, roept de standaard implementatie van die methode InitMouseManageraan.

Als uw toepassing al een muisbeheerder heeft en u InitMouseManageraanroept, heeft uw toepassing een ASSERT fout. Daarom moet u InitMouseManager niet aanroepen als u rechtstreeks een CMouseManager-object maakt. Als u geen aangepaste CMouseManagergebruikt, moet u GetMouseManager gebruiken om een CMouseManager-object te maken.

CWinAppEx::InitShellManager

Initialiseert het CShellManager-object.

BOOL InitShellManager();

Retourwaarde

Niet-nul als de methode het CShellManager-object maakt; 0 als het CShellManager object al bestaat.

Opmerkingen

Als u CWinAppEx::GetShellManageraanroept, roept de standaard implementatie van die methode InitShellManageraan.

Als uw toepassing al een shell-manager heeft en u InitShellManageraanroept, veroorzaakt uw toepassing een ASSERT fout. Roep daarom geen InitShellManager aan als u rechtstreeks een CShellManager-object maakt. Als u geen aangepaste CShellManagergebruikt, gebruikt u GetShellManager om een CShellManager-object te maken.

CWinAppEx::InitTooltipManager

Initialiseert het CTooltipManager-object.

BOOL InitTooltipManager();

Retourwaarde

Niet-nul als de methode het CTooltipManager-object maakt; 0 als het CTooltipManager object al bestaat.

Opmerkingen

Als u CWinAppEx::GetTooltipManageraanroept, roept de standaard implementatie van die methode InitTooltipManageraan.

Als uw toepassing al een knopinfobeheer heeft en u InitTooltipManageraanroept, heeft uw toepassing een ASSERT fout. Daarom moet u InitTooltipManager niet aanroepen als u rechtstreeks een CTooltipManager-object maakt. Als u geen aangepaste CTooltipManagergebruikt, moet u GetTooltipManager gebruiken om een CTooltipManager-object te maken.

CWinAppEx::IsResourceSmartUpdate

BOOL IsResourceSmartUpdate() const;

Retourwaarde

Opmerkingen

CWinAppEx::IsStateExists

Geeft aan of de opgegeven sleutel zich in het register bevindt.

BOOL IsStateExists(LPCTSTR lpszSectionName);

Parameters

lpszSectionName
[in] Een tekenreeks die een pad van een registersleutel bevat.

Retourwaarde

Niet-nul als de sleutel zich in het register bevindt; anders 0.

CWinAppEx::LoadCustomState

In het framework wordt deze methode aangeroepen nadat de status van de toepassing uit het register is geladen.

virtual void LoadCustomState();

Opmerkingen

Overschrijf deze methode als u bewerkingen wilt uitvoeren nadat de toepassing de status van het register heeft geladen. Deze methode doet standaard niets.

Als u aangepaste statusgegevens uit het register wilt laden, moet de informatie eerst worden opgeslagen met behulp van CWinAppEx::SaveCustomState.

CWinAppEx::LoadState

Leest de toepassingsstatus uit het Windows-register.

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);

Parameters

pFrame
[in] Een aanwijzer naar een framevensterobject. De methode past de statusinformatie in het register toe op dit framevenster.

lpszSectionName
[in] Een tekenreeks die het relatieve pad van een registersleutel bevat.

pFrameImpl
[in] Een aanwijzer naar een CFrameImpl-object. De methode past de statusinformatie in het register toe op dit framevenster.

Retourwaarde

Niet-nul indien geslaagd; 0 anders.

Opmerkingen

Met deze methode wordt de status van de toepassing en eventuele statusinformatie voor een framevenster geladen. De geladen informatie voor het framevenster wordt toegepast op het opgegeven framevenster. Als u geen framevenster opgeeft, wordt alleen de informatie over de toepassingsstatus geladen. De toepassingsgegevens bevatten de status van de CMouseManager Klasse, CContextMenuManager Class, CKeyboardManager Classen de CUserToolsManager Class.

De standaard implementatie van CFrameImpl::OnLoadFrame roept LoadStateaan.

De parameter lpszSectionName is niet het absolute pad voor een registervermelding. Het is een relatief pad dat wordt toegevoegd aan het einde van de standaardregistersleutel voor uw toepassing. Als u de standaardregistersleutel wilt ophalen of instellen, gebruikt u respectievelijk de methoden CWinAppEx::GetRegistryBase en CWinAppEx::SetRegistryBase.

CWinAppEx::LoadWindowPlacement

Aangeroepen door het framework wanneer het de grootte en locatie van het hoofdframevenster uit het register laadt.

virtual BOOL LoadWindowPlacement(
    CRect& rectNormalPosition,
    int& nFlags,
    int& nShowCmd);

Parameters

rectNormalPosition
[uit] Een rechthoek met de coördinaten van het hoofdframevenster wanneer deze zich in de herstelde positie bevindt.

nFlags
[uit] Vlaggen die de positie van het geminimaliseerde venster bepalen en hoe het besturingssysteem schakelt tussen een geminimaliseerd venster en een hersteld venster.

nShowCmd
[uit] Een geheel getal dat de weergavestatus van het venster aangeeft. Zie CWnd::ShowWindowvoor meer informatie over mogelijke waarden.

Retourwaarde

Niet-nul indien geslaagd; 0 anders.

Opmerkingen

Standaard laadt MFC automatisch de vorige positie en status van het hoofdframevenster wanneer de toepassing wordt gestart. Zie CWinAppEx::StoreWindowPlacementvoor meer informatie over hoe deze informatie wordt opgeslagen in het register.

Overschrijf deze methode als u aanvullende informatie over het hoofdframevenster wilt laden.

CWinAppEx::m_bForceImageReset

Hiermee geeft u op of het framework alle werkbalkafbeeldingen opnieuw instelt wanneer het framevenster met de werkbalk opnieuw wordt geladen.

BOOL m_bForceImageReset;

Opmerkingen

Het m_bForceImageReset gegevenslid is een beveiligde variabele.

CWinAppEx::OnAppContextHelp

Dit framework roept deze methode aan wanneer de gebruiker contextondersteuning aanvraagt voor het dialoogvenster Aanpassing.

virtual void OnAppContextHelp(
    CWnd* pWndControl,
    const DWORD dwHelpIDArray[]);

Parameters

pWndControl
[in] Een aanwijzer naar een vensterobject waarvoor de gebruiker contextondersteuning heeft aangeroepen.

dwHelpIDArray[]
[in] Een gereserveerde waarde.

Opmerkingen

Deze methode is momenteel gereserveerd voor toekomstig gebruik. De standaard implementatie doet niets en wordt momenteel niet aangeroepen door het framework.

CWinAppEx::OnClosingMainFrame

Het framework roept deze methode aan wanneer een framevenster WM_CLOSEverwerkt.

virtual void OnClosingMainFrame(CFrameImpl* pFrameImpl);

Parameters

pFrameImpl
[in] Een aanwijzer naar een CFrameImpl-object.

Opmerkingen

De standaard implementatie van deze methode slaat de status van pFrameImplop.

CWinAppEx::OnViewDoubleClick

Roept de door de gebruiker gedefinieerde opdracht aan die is gekoppeld aan een weergave wanneer de gebruiker ergens in die weergave dubbelklikt.

virtual BOOL OnViewDoubleClick(
    CWnd* pWnd,
    int iViewId);

Parameters

pWnd
[in] Een aanwijzer naar een object dat is afgeleid van de CView Klasse.

iViewId
[in] De weergave-id.

Retourwaarde

TRUE als het framework een opdracht vindt; anders FALSE.

Opmerkingen

Als u aangepaste muisgedrag wilt ondersteunen, moet u deze functie aanroepen wanneer u het WM_LBUTTONDBLCLK bericht verwerkt. Met deze methode wordt de opdracht uitgevoerd die is gekoppeld aan de weergave-id die is opgegeven door iViewId. Zie toetsenbord- en muisaanpassingvoor meer informatie over aangepaste muisgedrag.

CWinAppEx::OnWorkspaceIdle

virtual BOOL OnWorkspaceIdle(CWnd*);

Parameters

[in] CWnd*

Retourwaarde

Opmerkingen

CWinAppEx::PreLoadState

Het framework roept deze methode onmiddellijk aan voordat de status van de toepassing vanuit het register wordt geladen.

virtual void PreLoadState();

Opmerkingen

Overschrijf deze methode als u bewerkingen direct wilt uitvoeren voordat het framework de toepassingsstatus laadt.

CWinAppEx::PreSaveState

Het framework roept deze methode onmiddellijk aan voordat de toepassingsstatus wordt opgeslagen.

virtual void PreSaveState();

Opmerkingen

Overschrijf deze methode als u bewerkingen direct wilt uitvoeren voordat het framework de toepassingsstatus opslaat.

CWinAppEx::ReloadWindowPlacement

Laadt de grootte en locatie van een venster opnieuw vanuit het register.

virtual BOOL ReloadWindowPlacement(CFrameWnd* pFrame);

Parameters

pFrame
[in] Een aanwijzer naar een framevenster.

Retourwaarde

Niet-nul als de methode is geslaagd; 0 als het laden is mislukt of er geen gegevens zijn om te laden.

Opmerkingen

Gebruik de functie CWinAppEx::StoreWindowPlacement om de grootte en locatie van een venster naar het register te schrijven.

CWinAppEx::SaveCustomState

Dit framework roept deze methode aan nadat de status van de toepassing is opgeslagen in het register.

virtual void SaveCustomState();

Opmerkingen

Overschrijf deze methode als u bewerkingen wilt uitvoeren nadat de toepassing de status in het register heeft opgeslagen. Deze methode doet standaard niets.

CWinAppEx::SaveState

Hiermee wordt de toepassingsstatus naar het Windows-register geschreven.

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);

Parameters

lpszSectionName
[in] Een tekenreeks die het relatieve pad van een registersleutel bevat.

pFrameImpl
[in] Een aanwijzer naar een CFrameImpl-object. Dit frame wordt opgeslagen in het Windows-register.

pFrame
[in] Een aanwijzer naar een framevensterobject. Dit frame wordt opgeslagen in het Windows-register.

Retourwaarde

TRUE indien geslaagd; FALSE anders.

Opmerkingen

Met deze methode worden de status van de toepassing en alle statusinformatie voor het opgegeven framevenster opgeslagen. Als u geen framevenster opgeeft, slaat de methode alleen de toepassingsstatus op. De toepassingsgegevens bevatten de status van de CMouseManager Klasse, CContextMenuManager Class, CKeyboardManager Classen de CUserToolsManager Class.

De parameter lpszSectionName is niet het absolute pad voor een registervermelding. Het is een relatief pad dat wordt toegevoegd aan het einde van de standaardregistersleutel voor uw toepassing. Als u de standaardregistersleutel wilt ophalen of instellen, gebruikt u respectievelijk de methoden CWinAppEx::GetRegistryBase en CWinAppEx::SetRegistryBase.

CWinAppEx::SetRegistryBase

Hiermee stelt u het standaardregisterpad voor de toepassing in.

LPCTSTR SetRegistryBase(LPCTSTR lpszSectionName = NULL);

Parameters

lpszSectionName
[in] Een tekenreeks die het pad van een registersleutel bevat.

Retourwaarde

Een tekenreeks die het pad van de standaardregisterlocatie bevat.

Opmerkingen

Alle methoden van de CWinAppEx Class die toegang hebben tot het register, beginnen op een standaardlocatie. Gebruik deze methode om die standaardregisterlocatie te wijzigen. Gebruik CWinAppEx::GetRegistryBase om de standaardregisterlocatie op te halen.

CWinAppEx::ShowPopupMenu

Hiermee wordt een pop-upmenu weergegeven.

virtual BOOL ShowPopupMenu(
    UINT uiMenuResId,
    const CPoint& point,
    CWnd* pWnd);

Parameters

uiMenuResId
[in] Een menuresource-id.

point
[in] Een CPoint die de positie van het menu in schermcoördinaten aangeeft.

pWnd
[in] Een aanwijzer naar het venster dat eigenaar is van het pop-upmenu.

Retourwaarde

Nonzero als het pop-upmenu met succes wordt weergegeven; 0 anders.

Opmerkingen

Met deze methode wordt het menu weergegeven dat is gekoppeld aan uiMenuResId.

Als u pop-upmenu's wilt ondersteunen, moet u een CContextMenuManager-object hebben. Als u het CContextMenuManager object niet hebt geïnitialiseerd, mislukt ShowPopupMenu.

CWinAppEx::StoreWindowPlacement

Aangeroepen door het framework om de grootte en locatie van het hoofdframevenster naar het register te schrijven.

virtual BOOL StoreWindowPlacement(
    const CRect& rectNormalPosition,
    int nFlags,
    int nShowCmd);

Parameters

nFlags
[in] Vlaggen die de positie van het geminimaliseerde venster bepalen en hoe het besturingssysteem schakelt tussen een geminimaliseerd venster en een hersteld venster.

nShowCmd
[in] Een geheel getal dat de weergavestatus van het venster aangeeft. Zie CWnd::ShowWindowvoor meer informatie over mogelijke waarden.

rectNormalPosition
[in] Een rechthoek met de coördinaten van het hoofdframevenster wanneer deze zich in de herstelde staat bevindt.

Retourwaarde

Niet-nul indien geslaagd; 0 anders.

Opmerkingen

Standaard slaat MFC automatisch de positie en status van het hoofdframevenster op voordat de toepassing wordt afgesloten. Deze informatie wordt opgeslagen in het Windows-register onder de WindowPlacement-sleutel in de standaardregisterlocatie voor uw toepassing. Zie CWinAppEx::GetRegistryBasevoor meer informatie over de standaardregisterlocatie van uw toepassing.

Overschrijf deze methode als u aanvullende informatie over het hoofdframevenster wilt opslaan.

CWinAppEx::WriteBinary

Hiermee worden binaire gegevens naar het register geschreven.

BOOL WriteBinary(
    LPCTSTR lpszEntry,
    LPBYTE pData,
    UINT nBytes);

Parameters

lpszEntry
[in] Een tekenreeks die de naam van een registersleutel bevat.

pData
[in] De gegevens die moeten worden opgeslagen.

nBytes
[in] De grootte van pData in bytes.

Retourwaarde

TRUE als deze methode is geslaagd; anders FALSE.

Opmerkingen

De parameter lpszEntry is de naam van een registervermelding die zich onder de standaardregistersleutel voor uw toepassing bevindt. Als u de standaardregistersleutel wilt ophalen of instellen, gebruikt u respectievelijk de methoden CWinAppEx::GetRegistryBase en CWinAppEx::SetRegistryBase.

Als de sleutel die is opgegeven door lpszEntry niet bestaat, wordt deze met deze methode gemaakt.

CWinAppEx::WriteInt

Schrijft numerieke gegevens naar het register.

BOOL WriteInt(
    LPCTSTR lpszEntry,
    int nValue);

Parameters

lpszEntry
[in] Een tekenreeks die de naam van een registersleutel bevat.

nValue
[in] De gegevens die moeten worden opgeslagen.

Retourwaarde

TRUE als deze methode is geslaagd; anders FALSE.

Opmerkingen

De parameter lpszEntry is de naam van een registervermelding die zich onder de standaardregistersleutel voor uw toepassing bevindt. Als u de standaardregistersleutel wilt ophalen of instellen, gebruikt u respectievelijk de methoden CWinAppEx::GetRegistryBase en CWinAppEx::SetRegistryBase.

Als de sleutel die is opgegeven door lpszEntry niet bestaat, wordt deze met deze methode gemaakt.

CWinAppEx::WriteObject

Schrijft gegevens die zijn afgeleid van de CObject Class naar het register.

BOOL WriteObject(
    LPCTSTR lpszEntry,
    CObject& obj);

Parameters

lpszEntry
[in] Een tekenreeks die de waarde bevat die moet worden ingesteld.

obj
[in] Een verwijzing naar CObject gegevens die door de methode worden opgeslagen.

Retourwaarde

TRUE als deze methode is geslaagd; anders FALSE.

Opmerkingen

Met deze methode worden de obj gegevens naar de opgegeven waarde geschreven onder de standaardregistersleutel. Gebruik CWinAppEx::GetRegistryBase om de huidige registersleutel te bepalen.

CWinAppEx::WriteSectionBinary

Schrijft binaire gegevens naar een waarde in het register.

BOOL WriteSectionBinary(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    LPBYTE pData,
    UINT nBytes);

Parameters

lpszSubSection
[in] Een tekenreeks die de naam van een registersleutel bevat

lpszEntry
[in] Een tekenreeks die de waarde bevat die moet worden ingesteld.

pData
[in] De gegevens die naar het register moeten worden geschreven.

nBytes
[in] De grootte van pData in bytes.

Retourwaarde

TRUE als deze methode is geslaagd; anders FALSE.

Opmerkingen

De parameter lpszSubSection is niet het absolute pad voor een registervermelding. Het is een relatief pad dat wordt toegevoegd aan het einde van de standaardregistersleutel voor uw toepassing. Als u de standaardregistersleutel wilt ophalen of instellen, gebruikt u respectievelijk de methoden CWinAppEx::GetRegistryBase en CWinAppEx::SetRegistryBase.

Als de sleutel die is opgegeven door lpszEntry niet bestaat, wordt deze met deze methode gemaakt.

CWinAppEx::WriteSectionInt

Schrijft numerieke gegevens naar het register.

BOOL WriteSectionInt(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    int nValue);

Parameters

lpszSubSection
[in] Een tekenreeks die het relatieve pad van een registersleutel bevat.

lpszEntry
[in] Een tekenreeks die de waarde bevat die moet worden ingesteld.

nValue
[in] De gegevens die naar het register moeten worden geschreven.

Retourwaarde

TRUE als deze methode is geslaagd; anders FALSE.

Opmerkingen

De parameter lpszSubSection is geen absoluut pad voor een registervermelding. Het is een relatief pad dat wordt toegevoegd aan de standaardregistersleutel voor uw toepassing. Als u de standaardregistersleutel wilt ophalen of instellen, gebruikt u respectievelijk de methoden CWinAppEx::GetRegistryBase en CWinAppEx::SetRegistryBase.

Als de sleutel die is opgegeven door lpszEntry niet bestaat, wordt deze met deze methode gemaakt.

CWinAppEx::WriteSectionObject

Hiermee schrijft u gegevens die zijn afgeleid van de CObject Class naar een specifieke registerwaarde.

BOOL WriteSectionObject(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    CObject& obj);

Parameters

lpszSubSection
[in] Een tekenreeks die de naam van een registersleutel bevat.

lpszEntry
[in] Een tekenreeks die de naam van de waarde bevat die moet worden ingesteld.

obj
[in] De gegevens die moeten worden opgeslagen.

Retourwaarde

TRUE als deze methode is geslaagd; anders FALSE.

Opmerkingen

De parameter lpszSubSection is geen absoluut pad voor een registervermelding. Het is een relatief pad dat wordt toegevoegd aan het einde van de standaardregistersleutel voor uw toepassing. Als u de standaardregistersleutel wilt ophalen of instellen, gebruikt u respectievelijk de methoden CWinAppEx::GetRegistryBase en CWinAppEx::SetRegistryBase.

Als de waarde die is opgegeven door lpszEntry niet bestaat onder de registersleutel die is opgegeven door lpszSubSection, maakt deze methode die waarde.

CWinAppEx::WriteSectionString

Hiermee schrijft u tekenreeksgegevens naar een waarde in het register.

BOOL WriteSectionString(
    LPCTSTR lpszSubSection,
    LPCTSTR lpszEntry,
    LPCTSTR lpszValue);

Parameters

lpszSubSection
[in] Een tekenreeks die de naam van een registersleutel bevat.

lpszEntry
[in] Een tekenreeks die de waarde bevat die moet worden ingesteld.

lpszValue
[in] De tekenreeksgegevens die naar het register moeten worden geschreven.

Retourwaarde

TRUE als deze methode is geslaagd; anders FALSE.

Opmerkingen

De parameter lpszSubSection is geen absoluut pad voor een registervermelding. Het is een relatief pad dat wordt toegevoegd aan het einde van de standaardregistersleutel voor uw toepassing. Als u de standaardregistersleutel wilt ophalen of instellen, gebruikt u respectievelijk de methoden CWinAppEx::GetRegistryBase en CWinAppEx::SetRegistryBase.

Als de waarde die is opgegeven door lpszEntry niet bestaat onder lpszSubSection, wordt deze met deze methode gemaakt.

CWinAppEx::WriteString

Hiermee worden tekenreeksgegevens naar het register geschreven.

BOOL WriteString(
    LPCTSTR lpszEntry,
    LPCTSTR lpszValue);

Parameters

lpszEntry
[in] Een tekenreeks die de naam van een registersleutel bevat.

lpszValue
[in] De gegevens die moeten worden opgeslagen.

Retourwaarde

TRUE als deze methode is geslaagd; anders FALSE.

Opmerkingen

De parameter lpszEntry is de naam van een registervermelding die zich onder de standaardregistersleutel voor uw toepassing bevindt. Als u de standaardregistersleutel wilt ophalen of instellen, gebruikt u respectievelijk de methoden CWinAppEx::GetRegistryBase en CWinAppEx::SetRegistryBase.

Als de sleutel die is opgegeven door lspzEntry niet bestaat, wordt deze met deze methode gemaakt.

Zie ook

Hiërarchiegrafiek
klassen
CWinApp klasse
CMouseManager klasse
CContextMenuManager klasse
CKeyboardManager klasse
CUserToolsManager klasse