CWinAppEx osztály

CWinAppEx kezeli az alkalmazás állapotát, menti az állapotot a beállításjegyzékbe, betölti az állapotot a beállításjegyzékből, inicializálja az alkalmazáskezelőket, és hivatkozásokat biztosít ugyanarra az alkalmazáskezelőre.

További részletekért tekintse meg a Visual Studio-telepítés mfc mappájában található forráskódot. Például %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Szintaxis

class CWinAppEx : public CWinApp

Tagok

Nyilvános konstruktorok

Név	Leírás
CWinAppEx::CWinAppEx	Egy CWinAppEx objektumot hoz létre.

Nyilvános metódusok

Név	Leírás
CWinAppEx::CleanState	Eltávolítja az alkalmazással kapcsolatos információkat a Windows-beállításjegyzékből.
CWinAppEx::EnableLoadWindowPlacement	Megadja, hogy az alkalmazás betölti-e a fő keretablak kezdeti méretét és helyét a beállításjegyzékből.
CWinAppEx::EnableTearOffMenus	Engedélyezi a lebontás menüit az alkalmazás számára.
CWinAppEx::EnableUserTools	Lehetővé teszi, hogy a felhasználó egyéni menüparancsokat hozzon létre az alkalmazásban.
CWinAppEx::ExitInstance	A keretrendszer meghívta a Run tagfüggvényből, hogy kilépjen az alkalmazás ezen példányából. (Felülbírálások CWinApp::ExitInstance.)
CWinAppEx::GetBinary	Beolvassa a megadott beállításjegyzék-értékhez társított bináris adatokat.
CWinAppEx::GetContextMenuManager	A globális CContextMenuManager objektumra mutató mutatót ad vissza.
CWinAppEx::GetDataVersion
CWinAppEx::GetDataVersionMajor	A Windows beállításjegyzékben mentett alkalmazás főverzióját adja vissza.
CWinAppEx::GetDataVersionMinor	A Windows beállításjegyzékben mentett alkalmazás alverzióját adja vissza.
CWinAppEx::GetInt	Beolvassa a megadott értékhez társított numerikus adatokat a beállításjegyzékből.
CWinAppEx::GetKeyboardManager	A globális CKeyboardManager objektumra mutató mutatót ad vissza.
CWinAppEx::GetMouseManager	A globális CMouseManager objektumra mutató mutatót ad vissza.
CWinAppEx::GetObject	Beolvassa CObjecta beállításjegyzékből a megadott értékhez társított származtatott adatokat.
CWinAppEx::GetRegSectionPath	Egy beállításkulcs elérési útját tartalmazó sztringet ad vissza. Ez az elérési út összefűzi a megadott relatív elérési utat az alkalmazás elérési útjával.
CWinAppEx::GetRegistryBase	Az alkalmazás beállításjegyzék-elérési útját adja vissza.
CWinAppEx::GetSectionBinary	Beolvassa a megadott kulcshoz és értékhez társított bináris adatokat a beállításjegyzékből.
CWinAppEx::GetSectionInt	Beolvassa a megadott kulccsal és értékkel társított numerikus adatokat a beállításjegyzékből.
CWinAppEx::GetSectionObject	Beolvassa CObject megadott kulcshoz és értékhez társított adatokat a beállításjegyzékből.
CWinAppEx::GetSectionString	Beolvassa a megadott kulcshoz és értékhez társított sztringadatokat a beállításjegyzékből.
CWinAppEx::GetShellManager	A globális CShellManager objektumra mutató mutatót ad vissza.
CWinAppEx::GetString	Beolvassa a megadott értékhez társított sztringadatokat a beállításjegyzékből.
CWinAppEx::GetTooltipManager	A globális CTooltipManager objektumra mutató mutatót ad vissza.
CWinAppEx::GetUserToolsManager	A globális CUserToolsManager objektumra mutató mutatót ad vissza.
CWinAppEx::InitContextMenuManager	Inicializálja a CContextMenuManager objektumot.
CWinAppEx::InitKeyboardManager	Inicializálja a CKeyboardManager objektumot.
CWinAppEx::InitMouseManager	Inicializálja a CMouseManager objektumot.
CWinAppEx::InitShellManager	Inicializálja a CShellManager osztályt
CWinAppEx::InitTooltipManager	Inicializálja a CTooltipManager osztályt.
CWinAppEx::IsResourceSmartUpdate
CWinAppEx::IsStateExists	Azt jelzi, hogy a megadott kulcs szerepel-e a beállításjegyzékben.
CWinAppEx::LoadState	Betölti az alkalmazás állapotát a beállításjegyzékből.
CWinAppEx::OnAppContextHelp	A keretrendszer meghívja, amikor a felhasználó környezeti segítséget kér a Testreszabás párbeszédpanelhez.
CWinAppEx::OnViewDoubleClick	Meghívja a felhasználó által megadott parancsot, amikor a felhasználó duplán kattint az alkalmazás tetszőleges pontjára.
CWinAppEx::OnWorkspaceIdle
CWinAppEx::SaveState	Az alkalmazás-keretrendszer állapotát írja a Windows beállításjegyzékbe.
CWinAppEx::SetRegistryBase	Beállítja az alapértelmezett beállításkulcs elérési útját. Ez a kulcs lesz az összes későbbi beállításjegyzék-hívás gyökere.
CWinAppEx::ShowPopupMenu	Előugró menüt jelenít meg.
CWinAppEx::WriteBinary	A bináris adatokat a megadott beállításjegyzék-értékre írja.
CWinAppEx::WriteInt	A numerikus adatokat a megadott beállításjegyzék-értékre írja.
CWinAppEx::WriteObject	A CObject osztályból származó adatokat írja a megadott beállításjegyzék-értékre.
CWinAppEx::WriteSectionBinary	A bináris adatokat a megadott beállításkulcs értékére írja.
CWinAppEx::WriteSectionInt	A numerikus adatokat a megadott beállításkulcs értékére írja.
CWinAppEx::WriteSectionObject	A CObject osztályból származó adatokat a megadott beállításkulcs értékére írja.
CWinAppEx::WriteSectionString	A sztringadatokat a megadott beállításkulcs értékére írja.
CWinAppEx::WriteString	A sztringadatokat a megadott beállításjegyzék-értékre írja.

Védett metódusok

Név	Leírás
CWinAppEx::LoadCustomState	Az alkalmazás állapotának betöltésekor a keretrendszer hívja meg.
CWinAppEx::LoadWindowPlacement	A keretrendszer meghívja, amikor betölti az alkalmazás méretét és helyét a beállításjegyzékből. A betöltött adatok tartalmazzák a fő keret méretét és helyét az alkalmazás utolsó bezárásakor.
CWinAppEx::OnClosingMainFrame	A keretrendszer meghívja, amikor egy fő keretablak WM_CLOSEdolgoz fel.
CWinAppEx::PreLoadState	A keretrendszer közvetlenül az alkalmazásállapot betöltése előtt hívja meg.
CWinAppEx::PreSaveState	A keretrendszer közvetlenül az alkalmazásállapot mentése előtt hívja meg.
CWinAppEx::ReloadWindowPlacement	Újra betölti a megadott ablak méretét és helyét a beállításjegyzékből
CWinAppEx::SaveCustomState	A keretrendszer meghívta, miután az alkalmazás állapotát a beállításjegyzékbe írta.
CWinAppEx::StoreWindowPlacement	A keretrendszer meghívta a fő keret méretét és helyét a beállításjegyzékbe.

Adattagok

Név	Leírás
CWinAppEx::m_bForceImageReset	Megadja, hogy a keretrendszer visszaállítja-e az összes eszköztárképet az eszköztárat tartalmazó keretablak betöltésekor.

Megjegyzések

Az MFC-keretrendszer által biztosított funkciók nagy része a CWinAppEx osztálytól függ. A CWinAppEx osztályt kétféleképpen építheti be az alkalmazásba:

• Hozzon létre egy CWinAppEx osztályt a főszálban.

• A fő alkalmazásosztály származtatása CWinAppEx.

Miután belefoglalta CWinAppEx az alkalmazásba, inicializálhatja bármelyik alkalmazáskezelőt. Az alkalmazáskezelő használata előtt inicializálnia kell azt a megfelelő inicializálási módszer meghívásával. Ha egy adott vezetőhöz szeretne mutatót szerezni, hívja meg a társított get metódust. A CWinAppEx osztály a következő alkalmazáskezelőket kezeli: CMouseManager osztály, CContextMenuManager osztály, CKeyboardManager osztály, CUserToolsManager osztályés CMenuTearOffManager osztály.

Öröklési hierarchia

CObject

CCmdTarget

CWinThread

CWinApp

CWinAppEx

Követelmények

fejléc:afxwinappex.h

CWinAppEx::CleanState

Eltávolítja az alkalmazással kapcsolatos összes információt a Windows beállításjegyzékéből.

virtual BOOL CleanState(LPCTSTR lpszSectionName=NULL);

Paraméterek

lpszSectionName
[in] Egy beállításkulcs elérési útját tartalmazó sztring.

Visszaadott érték

Nonzero, ha a módszer sikeres volt; egyéb esetben 0.

Megjegyzések

Ez a módszer törli az alkalmazásadatokat a beállításjegyzék egy adott szakaszából. A törölni kívánt szakaszt a lpszSectionNameparaméterrel adhatja meg. Ha lpszSectionNameNULL, ez a metódus a CWinAppEx objektumban tárolt alapértelmezett beállításjegyzék-elérési utat fogja használni. Az alapértelmezett beállításjegyzék-elérési út lekéréséhez használja CWinAppEx::GetRegistryBase.

CWinAppEx::CWinAppEx

Egy CWinAppEx objektumot hoz létre.

CWinAppEx(BOOL bResourceSmartUpdate = FALSE);

Paraméterek

bResourceSmartUpdate
[in] Logikai paraméter, amely meghatározza, hogy a munkaterület-objektum észlelje-e és kezelje-e az erőforrás-frissítéseket.

Megjegyzések

A CWinAppEx osztály inicializálási módszerekkel rendelkezik, lehetővé teszi az alkalmazásadatok beállításjegyzékbe való mentését és betöltését, valamint a globális alkalmazásbeállításokat. Emellett olyan globális vezetők használatát is lehetővé teszi, mint a CKeyboardManager osztály és a CUserToolsManager osztály. Minden alkalmazásnak csak egy példánya lehet a CWinAppEx osztálynak.

CWinAppEx::EnableLoadWindowPlacement

Megadja, hogy az alkalmazás betölti-e a fő keretablak kezdeti méretét és helyét a beállításjegyzékből.

void EnableLoadWindowPlacement(BOOL bEnable = TRUE);

Paraméterek

bEnable
[in] Megadja, hogy az alkalmazás betölti-e a fő keretablak kezdeti méretét és helyét a beállításjegyzékből.

Megjegyzések

Alapértelmezés szerint a rendszer betölti a fő keret méretét és helyét a beállításjegyzékből más alkalmazásbeállításokkal együtt. Ez a CWinAppEx::LoadStatesorán fordul elő. Ha nem szeretné betölteni a kezdeti ablakelhelyezést a beállításjegyzékből, hívja meg ezt a metódust úgy, hogy bEnableFALSE.

CWinAppEx::EnableTearOffMenus

Létrehoz és inicializál egy CMenuTearOffManager objektumot.

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

Paraméterek

lpszRegEntry
[in] Egy beállításkulcs elérési útját tartalmazó sztring. Az alkalmazás ezt a beállításkulcsot használja a letört menük információinak tárolására.

uiCmdFirst
[in] Az első lebontás menüazonosítója.

uiCmdLast
[in] Az utolsó lebontás menüazonosítója.

Visszaadott érték

TRUE, hogy a CMenuTearOffManager sikeresen létrejött-e és inicializálódott-e; FALSE, hogy hiba történik-e, vagy ha a CMenuTearOffManager már létezik.

Megjegyzések

Ezzel a függvénnyel engedélyezheti a lebontás menüit az alkalmazásban. Ezt a függvényt a InitInstancekell meghívnia.

CWinAppEx::EnableUserTools

Lehetővé teszi, hogy a felhasználó egyéni menüparancsokat hozzon létre, amelyek csökkentik a billentyűleütéseket az alkalmazásban. Ez a metódus létrehoz egy CUserToolsManager objektumot.

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

Paraméterek

uiCmdToolsDummy
[in] Egy aláíratlan egész szám, amelyet a keretrendszer a felhasználói eszközök menü parancsazonosítójának helyőrzőjeként használ.

uiCmdFirst
[in] Az első felhasználói eszköz parancsának parancsazonosítója.

uiCmdLast
[in] Az utolsó felhasználói eszköz parancsának parancsazonosítója.

pToolRTC
[in] Egy osztály, amelyet az CUserToolsManager objektum új felhasználói eszközök létrehozásához használ.

uArgMenuID
[in] Az argumentum menüazonosítója.

uInitDirMenuID
[in] A kezdeti eszközkönyvtár menüazonosítója.

Visszaadott érték

TRUE, ha a metódus létrehoz és inicializál egy CUserToolsManager objektumot; FALSE, hogy a metódus sikertelen-e, vagy ha már létezik CUserToolsManager objektum.

Megjegyzések

Ha engedélyezi a felhasználó által definiált eszközöket, a keretrendszer automatikusan támogat egy dinamikus menüt, amely a testreszabás során bővíthető. A keretrendszer minden új elemet egy külső parancshoz társít. A keretrendszer meghívja ezeket a parancsokat, amikor a felhasználó kiválasztja a megfelelő elemet a Eszközök menüből.

Minden alkalommal, amikor a felhasználó hozzáad egy új elemet, a keretrendszer létrehoz egy új objektumot. Az új objektum osztálytípusát a pToolRTChatározza meg. A pToolRTC osztálytípust a CUserTool osztály.

További információ a felhasználói eszközökről és azok alkalmazásba való beépítéséről: Felhasználó által definiált eszközök.

CWinAppEx::ExitInstance

virtual int ExitInstance();

Visszaadott érték

Megjegyzések

CWinAppEx::GetBinary

Bináris adatokat olvas be egy megadott beállításkulcsból.

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

Paraméterek

lpszEntry
[in] Egy beállításkulcs nevét tartalmazó sztring.

ppData
[kifelé] Mutató arra a pufferre, amelyet a metódus a bináris adatokkal tölt ki.

pBytes
[kifelé] Mutató egy aláíratlan egész számra, amelyet a metódus az olvasási bájtok számának megírására használ.

Visszaadott érték

sikeres TRUE; máskülönben FALSE.

Megjegyzések

Ez a metódus beolvassa a beállításjegyzékbe írt bináris adatokat. Ha adatokat szeretne írni a beállításjegyzékbe, használja a CWinAppEx::WriteBinary és CWinAppEx::WriteSectionBinarymetódusokat.

A lpszEntry paraméter az alkalmazás alapértelmezett beállításkulcsa alatt található beállításjegyzék-bejegyzés neve. Az alapértelmezett beállításkulcs lekéréséhez vagy beállításához használja az CWinAppEx::GetRegistryBase és a CWinAppEx::SetRegistryBase metódusokat.

CWinAppEx::GetContextMenuManager

A globális CContextMenuManager objektumra mutató mutatót ad vissza.

CContextMenuManager* GetContextMenuManager();

Visszaadott érték

Mutató a globális CContextMenuManager objektumra.

Megjegyzések

Ha a CContextMenuManager objektum nincs inicializálva, ez a függvény meghívja CWinAppEx::InitContextMenuManager, mielőtt mutatót ad vissza.

CWinAppEx::GetDataVersion

int GetDataVersion() const;

Visszaadott érték

Megjegyzések

CWinAppEx::GetDataVersionMajor

Az alkalmazás főverzióját adja vissza, amely CWinAppEx::SaveStatehívásakor a Windows beállításjegyzékében lesz mentve.

int GetDataVersionMajor() const;

Visszaadott érték

A főverzió számát tartalmazó egész szám.

CWinAppEx::GetDataVersionMinor

Az alkalmazás alverzióját adja vissza, amely CWinAppEx::SaveStatehívásakor a Windows beállításjegyzékében lesz mentve.

int GetDataVersionMinor() const;

Visszaadott érték

Az alverzió számát tartalmazó egész szám.

CWinAppEx::GetInt

Egész számadatokat olvas be egy megadott beállításkulcsból.

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

Paraméterek

lpszEntry
[in] Egy beállításjegyzék-bejegyzés nevét tartalmazó sztring.

nDefault
[in] A metódus által visszaadott alapértelmezett érték, ha a megadott beállításjegyzék-bejegyzés nem létezik.

Visszaadott érték

A beállításjegyzék adatai, ha a metódus sikeres volt; egyéb esetben nDefault.

Megjegyzések

Ez a metódus egész számadatokat olvas be a beállításjegyzékből. Ha a beállításkulcshoz nincs társítva egész szám, amelyet a lpszEntryjelez, ez a metódus nDefaultad vissza. Ha adatokat szeretne írni a beállításjegyzékbe, használja a CWinAppEx::WriteSectionInt és CWinAppEx::WriteIntmetódusokat.

A lpszEntry paraméter az alkalmazás alapértelmezett beállításkulcsa alatt található beállításjegyzék-bejegyzés neve. Az alapértelmezett beállításkulcs lekéréséhez vagy beállításához használja az CWinAppEx::GetRegistryBase és a CWinAppEx::SetRegistryBase metódusokat.

CWinAppEx::GetKeyboardManager

A globális CKeyboardManager objektumra mutató mutatót ad vissza.

CKeyboardManager* GetKeyboardManager();

Visszaadott érték

Mutató a globális CKeyboardManager objektumra.

Megjegyzések

Ha a billentyűzetkezelő nincs inicializálva, ez a függvény meghívja CWinAppEx::InitKeyboardManager, mielőtt visszaad egy mutatót.

CWinAppEx::GetMouseManager

A globális CMouseManager objektumra mutató mutatót ad vissza.

CMouseManager* GetMouseManager();

Visszaadott érték

Mutató a globális CMouseManager objektumra.

Megjegyzések

Ha az egérkezelő nincs inicializálva, ez a függvény meghívja CWinAppEx::InitMouseManager, mielőtt visszaad egy mutatót.

CWinAppEx::GetObject

Beolvassa CObject-dervied adatokat a beállításjegyzékből.

BOOL GetObject(
    LPCTSTR lpszEntry,
    CObject& obj);

Paraméterek

lpszEntry
[in] Egy beállításjegyzék-bejegyzés relatív elérési útját tartalmazó sztring.

obj
[kifelé] Hivatkozás egy CObject. A metódus ezt a hivatkozást használja a beállításjegyzék adatainak tárolására.

Visszaadott érték

Nonzero, ha a módszer sikeres volt; egyéb esetben 0.

Megjegyzések

Ez a metódus beolvassa a CObjectszármazó adatokat a beállításjegyzékből. Ha CObject adatokat szeretne írni a beállításjegyzékbe, használja CWinAppEx::WriteObject vagy CWinAppEx::WriteSectionObject.

A lpszEntry paraméter az alkalmazás alapértelmezett beállításkulcsában található beállításjegyzék-bejegyzés neve. Az alapértelmezett beállításkulcs lekéréséhez vagy beállításához használja az CWinAppEx::GetRegistryBase és a CWinAppEx::SetRegistryBase metódusokat.

CWinAppEx::GetRegistryBase

Lekéri az alkalmazás alapértelmezett beállításjegyzék-elérési útját.

LPCTSTR GetRegistryBase();

Visszaadott érték

Az alapértelmezett beállításjegyzék-hely elérési útját tartalmazó sztring.

Megjegyzések

A beállításjegyzékhez hozzáférő CWinAppEx osztály összes metódusa alapértelmezett helyen kezdődik. Ezzel a módszerrel lekérheti az alapértelmezett beállításjegyzék-hely elérési útját. A beállításjegyzék alapértelmezett helyének módosításához használja a CWinAppEx::SetRegistryBase.

CWinAppEx::GetRegSectionPath

Létrehozza és visszaadja egy beállításkulcs abszolút elérési útját.

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

Paraméterek

szSectionAdd
[in] Egy beállításkulcs relatív elérési útját tartalmazó sztring.

Visszaadott érték

Egy beállításkulcs abszolút elérési útját tartalmazó CString.

Megjegyzések

Ez a módszer úgy határozza meg a beállításkulcs abszolút elérési útját, hogy hozzáfűzi az szSectionAdd relatív elérési útját az alkalmazás alapértelmezett beállításjegyzék-helyéhez. Az alapértelmezett beállításkulcs lekéréséhez használja a CWinAppEx::GetRegistryBasemetódust.

CWinAppEx::GetSectionBinary

Bináris adatokat olvas be a beállításjegyzékből.

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

Paraméterek

lpszSubSection
[in] Egy beállításkulcs relatív elérési útját tartalmazó sztring.

lpszEntry
[in] Az olvasni kívánt értéket tartalmazó sztring.

ppData
[kifelé] Mutató arra a pufferre, ahol a metódus tárolja az adatokat.

pBytes
[kifelé] Mutató egy aláíratlan egész számra. A metódus a ppData méretét írja ebbe a paraméterbe.

Visszaadott érték

sikeres TRUE; egyéb esetben FALSE.

Megjegyzések

Ez a metódus beolvassa a beállításjegyzékbe írt bináris adatokat a CWinAppEx::WriteBinary és CWinAppEx::WriteSectionBinarymetódusok használatával.

A lpszSubSection paraméter nem egy beállításjegyzék-bejegyzés abszolút elérési útja. Ez egy relatív elérési út, amely hozzá van fűzve az alkalmazás alapértelmezett beállításkulcsának végéhez. Az alapértelmezett beállításkulcs lekéréséhez vagy beállításához használja az CWinAppEx::GetRegistryBase és a CWinAppEx::SetRegistryBase metódusokat.

CWinAppEx::GetSectionInt

Egész számadatokat olvas be a beállításjegyzékből.

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

Paraméterek

lpszSubSection
[in] Egy beállításkulcs relatív elérési útját tartalmazó sztring.

lpszEntry
[in] Az olvasni kívánt értéket tartalmazó sztring.

nDefault
[in] Az alapértelmezett visszaadandó érték, ha a megadott érték nem létezik.

Visszaadott érték

A megadott beállításjegyzék-értékben tárolt egész számadatok; nDefault, ha az adatok nem léteznek.

Megjegyzések

A CWinAppEx::WriteInt és CWinAppEx::WriteSectionInt metódusokkal egész számadatokat írhat a beállításjegyzékbe.

A lpszSubSection paraméter nem egy beállításjegyzék-bejegyzés abszolút elérési útja. Ez egy relatív elérési út, amely az alkalmazás alapértelmezett beállításkulcsának végéhez lesz hozzáadva. Az alapértelmezett beállításkulcs lekéréséhez vagy beállításához használja az CWinAppEx::GetRegistryBase és a CWinAppEx::SetRegistryBase metódusokat.

CWinAppEx::GetSectionObject

Beolvassa CObject beállításjegyzék adatait a beállításjegyzékből.

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

Paraméterek

lpszSubSection
[in] Egy beállításkulcs relatív elérési útját tartalmazó sztring.

lpszEntry
[in] Az olvasni kívánt értéket tartalmazó sztring.

obj
[kifelé] Hivatkozás egy CObject. A metódus ezt a CObject használja a beállításjegyzék adatainak tárolására.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Ez a metódus adatokat olvas be a beállításjegyzékből. Az adatolvasás CObject adat, vagy egy CObjectszármazó osztály adatai. Ha CObject adatokat szeretne írni a beállításjegyzékbe, használja CWinAppEx::WriteObject vagy CWinAppEx::WriteSectionObject.

A lpszSubSection paraméter nem egy beállításjegyzék-bejegyzés abszolút elérési útja. Ez egy relatív elérési út, amely hozzá van fűzve az alkalmazás alapértelmezett beállításkulcsának végéhez. Az alapértelmezett beállításkulcs lekéréséhez vagy beállításához használja az CWinAppEx::GetRegistryBase és a CWinAppEx::SetRegistryBase metódusokat.

CWinAppEx::GetSectionString

Sztringadatokat olvas be a beállításjegyzékből.

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

Paraméterek

lpszSubSection
[in] Egy beállításkulcs relatív elérési útját tartalmazó sztring.

lpszEntry
[in] Az olvasni kívánt értéket tartalmazó sztring.

lpszDefault
[in] Az alapértelmezett visszaadandó érték, ha a megadott érték nem létezik.

Visszaadott érték

A megadott beállításjegyzék-értékben tárolt sztringadatok, ha az adatok léteznek; egyéb esetben lpszDefault.

Megjegyzések

Ez a metódus beolvassa a beállításjegyzékbe írt sztringadatokat. Sztringadatok írása a beállításjegyzékbe CWinAppEx::WriteString és CWinAppEx::WriteSectionString használatával.

A lpszSubSection paraméter nem egy beállításjegyzék-bejegyzés abszolút elérési útja. Ez egy relatív elérési út, amely hozzá van fűzve az alkalmazás alapértelmezett beállításkulcsának végéhez. Az alapértelmezett beállításkulcs lekéréséhez vagy beállításához használja az CWinAppEx::GetRegistryBase és a CWinAppEx::SetRegistryBase metódusokat.

CWinAppEx::GetShellManager

A globális CShellManager objektumra mutató mutatót ad vissza.

CShellManager* GetShellManager();

Visszaadott érték

Mutató a globális CShellManager objektumra.

Megjegyzések

Ha a CShellManager objektum nincs inicializálva, ez a függvény meghívja CWinAppEx::InitShellManager, mielőtt mutatót ad vissza.

CWinAppEx::GetString

Sztringadatokat olvas be egy megadott beállításkulcsból.

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

Paraméterek

lpszEntry
[in] Egy beállításkulcs nevét tartalmazó sztring

lpzDefault
[in] A metódus által visszaadott alapértelmezett érték, ha a megadott beállításjegyzék-bejegyzés nem létezik.

Visszaadott érték

A beállításjegyzékben tárolt sztringadatok, ha sikeresek; lpszDefault ellenkező esetben.

Megjegyzések

Ez a metódus beolvassa a beállításjegyzékbe írt sztringadatokat. Ha adatokat szeretne írni a beállításjegyzékbe, használja a CWinAppEx::WriteString vagy CWinAppEx::WriteSectionStringmetódusokat.

A lpszEntry paraméter az alkalmazás alapértelmezett beállításkulcsa alatt található beállításjegyzék-bejegyzés neve. Az alapértelmezett beállításkulcs lekéréséhez vagy beállításához használja az CWinAppEx::GetRegistryBase és a CWinAppEx::SetRegistryBase metódusokat.

CWinAppEx::GetTooltipManager

A globális CTooltipManager objektumra mutató mutatót ad vissza.

CTooltipManager* GetTooltipManager();

Visszaadott érték

Mutató a globális CTooltipManager objektumra.

Megjegyzések

Ha a CTooltipManager objektum nincs inicializálva, ez a függvény meghívja CWinAppEx::InitTooltipManager, mielőtt mutatót ad vissza.

CWinAppEx::GetUserToolsManager

A globális CUserToolsManager objektumra mutató mutatót ad vissza.

CUserToolsManager* GetUserToolsManager();

Visszaadott érték

Mutató a globális CUserToolsManager objektumra; NULL, ha a felhasználói eszközök kezelése nincs engedélyezve az alkalmazás számára.

Megjegyzések

Mielőtt a CUserToolsManager objektumra mutató mutatót kér le, inicializálnia kell a kezelőt CWinAppEx::EnableUserToolsmeghívásával.

CWinAppEx::InitContextMenuManager

Inicializálja a CContextMenuManager objektumot.

BOOL InitContextMenuManager();

Visszaadott érték

Nonzero, ha a metódus létrehozza a CContextMenuManager objektumot; 0, ha a CContextMenuManager objektum már létezik.

Megjegyzések

Ha meghívja CWinAppEx::GetContextMenuManager, a metódus alapértelmezett implementációja InitContextMenuManager.

Ha az alkalmazás már rendelkezik helyi menükezelővel, és meghívja InitContextMenuManager, az alkalmazásnak ASSERT hibája lesz. Ezért nem szabad meghívnia InitContextMenuManager, ha közvetlenül CContextMenuManager objektumot hoz létre. Ha nem egyéni CContextMenuManagerhasznál, GetContextMenuManager kell használnia egy CContextMenuManager objektum létrehozásához.

CWinAppEx::InitKeyboardManager

Inicializálja a CKeyboardManager objektumot.

BOOL InitKeyboardManager();

Visszaadott érték

Nonzero, ha a metódus létrehozza a CKeyboardManager objektumot; 0, ha a CKeyboardManager objektum már létezik.

Megjegyzések

Ha meghívja CWinAppEx::GetKeyboardManager, a metódus alapértelmezett implementációja InitKeyboardManager.

Ha az alkalmazás már rendelkezik billentyűzetkezelővel, és meghívja InitKeyboardManager, az alkalmazásnak ASSERT hibája lesz. Ezért nem szabad meghívnia InitKeyboardManager, ha közvetlenül CKeyboardManager objektumot hoz létre. Ha nem egyéni CKeyboardManagerhasznál, GetKeyboardManager kell használnia egy CKeyboardManager objektum létrehozásához.

CWinAppEx::InitMouseManager

Inicializálja a CMouseManager objektumot.

BOOL InitMouseManager();

Visszaadott érték

Nonzero, ha a metódus létrehozza a CMouseManager objektumot; 0, ha a CMouseManager objektum már létezik.

Megjegyzések

Ha meghívja CWinAppEx::GetMouseManager, a metódus alapértelmezett implementációja InitMouseManager.

Ha az alkalmazás már rendelkezik egérkezelővel, és meghívja InitMouseManager, az alkalmazás ASSERT hiba lép fel. Ezért nem szabad meghívnia InitMouseManager, ha közvetlenül CMouseManager objektumot hoz létre. Ha nem egyéni CMouseManagerhasznál, GetMouseManager kell használnia egy CMouseManager objektum létrehozásához.

CWinAppEx::InitShellManager

Inicializálja a CShellManager objektumot.

BOOL InitShellManager();

Visszaadott érték

Nonzero, ha a metódus létrehozza a CShellManager objektumot; 0, ha a CShellManager objektum már létezik.

Megjegyzések

Ha meghívja CWinAppEx::GetShellManager, a metódus alapértelmezett implementációja InitShellManager.

Ha az alkalmazás már rendelkezik rendszerhéj-kezelővel, és meghívja InitShellManager, az alkalmazás ASSERT hibát okozhat. Ezért ne hívja meg InitShellManager, ha közvetlenül CShellManager objektumot hoz létre. Ha nem egyéni CShellManagerhasznál, a GetShellManager használatával hozzon létre egy CShellManager objektumot.

CWinAppEx::InitTooltipManager

Inicializálja a CTooltipManager objektumot.

BOOL InitTooltipManager();

Visszaadott érték

Nonzero, ha a metódus létrehozza a CTooltipManager objektumot; 0, ha a CTooltipManager objektum már létezik.

Megjegyzések

Ha meghívja CWinAppEx::GetTooltipManager, a metódus alapértelmezett implementációja InitTooltipManager.

Ha az alkalmazás már rendelkezik elemleírás-kezelővel, és meghívja InitTooltipManager, az alkalmazásnak ASSERT hibája lesz. Ezért nem szabad meghívnia InitTooltipManager, ha közvetlenül CTooltipManager objektumot hoz létre. Ha nem egyéni CTooltipManagerhasznál, GetTooltipManager kell használnia egy CTooltipManager objektum létrehozásához.

CWinAppEx::IsResourceSmartUpdate

BOOL IsResourceSmartUpdate() const;

Visszaadott érték

Megjegyzések

CWinAppEx::IsStateExists

Azt jelzi, hogy a megadott kulcs szerepel-e a beállításjegyzékben.

BOOL IsStateExists(LPCTSTR lpszSectionName);

Paraméterek

lpszSectionName
[in] Egy beállításkulcs elérési útját tartalmazó sztring.

Visszaadott érték

Nonzero, ha a kulcs a beállításjegyzékben van; egyéb esetben 0.

CWinAppEx::LoadCustomState

A keretrendszer meghívja ezt a metódust, miután betölti az alkalmazás állapotát a beállításjegyzékből.

virtual void LoadCustomState();

Megjegyzések

Bírálja felül ezt a metódust, ha bármilyen feldolgozást szeretne végezni, miután az alkalmazás betölti az állapotot a beállításjegyzékből. Alapértelmezés szerint ez a metódus nem tesz semmit.

Ahhoz, hogy egyéni állapotinformációkat tölthessen be a beállításjegyzékből, először menteni kell az adatokat a CWinAppEx::SaveCustomStatehasználatával.

CWinAppEx::LoadState

Beolvassa az alkalmazás állapotát a Windows beállításjegyzékéből.

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éterek

pFrame
[in] Mutató egy keretablak-objektumra. A metódus a beállításjegyzék állapotadatait alkalmazza erre a keretablakra.

lpszSectionName
[in] Egy beállításkulcs relatív elérési útját tartalmazó sztring.

pFrameImpl
[in] Egy CFrameImpl objektumra mutató mutató. A metódus a beállításjegyzék állapotadatait alkalmazza erre a keretablakra.

Visszaadott érték

Nonzero, ha sikeres; 0 egyéb esetben.

Megjegyzések

Ez a metódus betölti az alkalmazás állapotát és a keretablak állapotadatait. A rendszer a keretablak betöltött adatait alkalmazza a megadott keretablakra. Ha nem ad meg keretablakot, csak az alkalmazásállapot adatai töltődnek be. Az alkalmazásinformációk tartalmazzák az CMouseManager osztály, CContextMenuManager osztály, CKeyboardManager osztályés a CUserToolsManager osztályállapotát.

A CFrameImpl::OnLoadFrame hívások alapértelmezett implementációja LoadState.

A lpszSectionName paraméter nem a beállításjegyzék-bejegyzés abszolút elérési útja. Ez egy relatív elérési út, amely az alkalmazás alapértelmezett beállításkulcsának végéhez lesz hozzáadva. Az alapértelmezett beállításkulcs lekéréséhez vagy beállításához használja az CWinAppEx::GetRegistryBase és a CWinAppEx::SetRegistryBase metódusokat.

CWinAppEx::LoadWindowPlacement

A keretrendszer meghívja, amikor betölti a fő keretablak méretét és helyét a beállításjegyzékből.

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

Paraméterek

rectNormalPosition
[kifelé] Egy téglalap, amely a fő keretablak koordinátáit tartalmazza a visszaállított pozícióban.

nFlags
[kifelé] Jelölők, amelyek a kis méretű ablak pozícióját szabályozzák, valamint azt, hogy az operációs rendszer hogyan vált a kis méretű és a visszaállított ablak között.

nShowCmd
[kifelé] Az ablak megjelenítési állapotát meghatározó egész szám. További információ a lehetséges értékekről: CWnd::ShowWindow.

Visszaadott érték

Nonzero, ha sikeres; 0 egyéb esetben.

Megjegyzések

Alapértelmezés szerint az MFC automatikusan betölti a fő keretablak előző pozícióját és állapotát az alkalmazás indításakor. Az információk beállításjegyzékben való tárolásáról további információt a CWinAppEx::StoreWindowPlacement.

Bírálja felül ezt a módszert, ha további információkat szeretne betölteni a fő keretablakról.

CWinAppEx::m_bForceImageReset

Megadja, hogy a keretrendszer visszaállítja-e az eszköztár összes képét, amikor újra betölti az eszköztárat tartalmazó keretablakot.

BOOL m_bForceImageReset;

Megjegyzések

A m_bForceImageReset adattag védett változó.

CWinAppEx::OnAppContextHelp

A keretrendszer meghívja ezt a metódust, amikor a felhasználó környezeti segítséget kér a Testreszabás párbeszédpanelhez.

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

Paraméterek

pWndControl
[in] Egy ablakobjektumra mutató mutató, amelyhez a felhasználó környezeti segítséget adott.

dwHelpIDArray[]
[in] Fenntartott érték.

Megjegyzések

Ez a módszer jelenleg a jövőbeli használatra van fenntartva. Az alapértelmezett implementáció nem végez semmit, és a keretrendszer jelenleg nem hívja meg.

CWinAppEx::OnClosingMainFrame

A keretrendszer akkor hívja meg ezt a metódust, ha egy keretablak WM_CLOSEdolgoz fel.

virtual void OnClosingMainFrame(CFrameImpl* pFrameImpl);

Paraméterek

pFrameImpl
[in] Egy CFrameImpl objektumra mutató mutató.

Megjegyzések

A metódus alapértelmezett implementációja menti a pFrameImplállapotát.

CWinAppEx::OnViewDoubleClick

Meghívja a nézethez társított felhasználó által megadott parancsot, amikor a felhasználó duplán kattint a nézet bármely pontjára.

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

Paraméterek

pWnd
[in] Mutató a CView osztályból származó objektumra.

iViewId
[in] A nézet azonosítója.

Visszaadott érték

TRUE, hogy a keretrendszer talál-e parancsot; egyéb esetben FALSE.

Megjegyzések

Az egyéni egér viselkedésének támogatásához meg kell hívnia ezt a függvényt a WM_LBUTTONDBLCLK üzenet feldolgozásakor. Ez a metódus végrehajtja a iViewIdáltal megadott nézetazonosítóhoz társított parancsot. További információ az egyéni egér viselkedéséről: Billentyűzet és egér testreszabása.

CWinAppEx::OnWorkspaceIdle

virtual BOOL OnWorkspaceIdle(CWnd*);

Paraméterek

[in] CWnd*

Visszaadott érték

Megjegyzések

CWinAppEx::PreLoadState

A keretrendszer közvetlenül azelőtt hívja meg ezt a metódust, hogy betöltené az alkalmazás állapotát a beállításjegyzékből.

virtual void PreLoadState();

Megjegyzések

Bírálja felül ezt a módszert, ha közvetlenül azelőtt szeretné elvégezni a feldolgozást, hogy a keretrendszer betöltené az alkalmazás állapotát.

CWinAppEx::PreSaveState

A keretrendszer közvetlenül az alkalmazásállapot mentése előtt meghívja ezt a metódust.

virtual void PreSaveState();

Megjegyzések

Bírálja felül ezt a metódust, ha közvetlenül azelőtt szeretné elvégezni a feldolgozást, hogy a keretrendszer menti az alkalmazás állapotát.

CWinAppEx::ReloadWindowPlacement

Egy ablak méretét és helyét újra betölti a beállításjegyzékből.

virtual BOOL ReloadWindowPlacement(CFrameWnd* pFrame);

Paraméterek

pFrame
[in] Mutató egy keretablakra.

Visszaadott érték

Nonzero, ha a módszer sikeres volt; 0, ha a terhelés sikertelen volt, vagy nincs betöltendő adat.

Megjegyzések

A CWinAppEx::StoreWindowPlacement függvénnyel írja be az ablak méretét és helyét a beállításjegyzékbe.

CWinAppEx::SaveCustomState

A keretrendszer meghívja ezt a metódust, miután menti az alkalmazás állapotát a beállításjegyzékbe.

virtual void SaveCustomState();

Megjegyzések

Bírálja felül ezt a metódust, ha bármilyen feldolgozást szeretne végezni, miután az alkalmazás mentette az állapotot a beállításjegyzékbe. Alapértelmezés szerint ez a metódus nem tesz semmit.

CWinAppEx::SaveState

Az alkalmazás állapotát a Windows beállításjegyzékbe írja.

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éterek

lpszSectionName
[in] Egy beállításkulcs relatív elérési útját tartalmazó sztring.

pFrameImpl
[in] Egy CFrameImpl objektumra mutató mutató. Ez a keret a Windows beállításjegyzékbe lesz mentve.

pFrame
[in] Mutató egy keretablak-objektumra. Ez a keret a Windows beállításjegyzékbe lesz mentve.

Visszaadott érték

sikeres TRUE; máskülönben FALSE.

Megjegyzések

Ez a metódus menti az alkalmazás állapotát és a megadott keretablak állapotadatait. Ha nem ad meg keretablakot, a metódus csak az alkalmazás állapotát menti. Az alkalmazásinformációk tartalmazzák az CMouseManager osztály, CContextMenuManager osztály, CKeyboardManager osztályés a CUserToolsManager osztályállapotát.

A lpszSectionName paraméter nem a beállításjegyzék-bejegyzés abszolút elérési útja. Ez egy relatív elérési út, amely hozzá van fűzve az alkalmazás alapértelmezett beállításkulcsának végéhez. Az alapértelmezett beállításkulcs lekéréséhez vagy beállításához használja az CWinAppEx::GetRegistryBase és a CWinAppEx::SetRegistryBase metódusokat.

CWinAppEx::SetRegistryBase

Beállítja az alkalmazás alapértelmezett beállításjegyzék-elérési útját.

LPCTSTR SetRegistryBase(LPCTSTR lpszSectionName = NULL);

Paraméterek

lpszSectionName
[in] Egy beállításkulcs elérési útját tartalmazó sztring.

Visszaadott érték

Az alapértelmezett beállításjegyzék-hely elérési útját tartalmazó sztring.

Megjegyzések

A beállításjegyzékhez hozzáférő CWinAppEx osztály összes metódusa alapértelmezett helyen kezdődik. Ezzel a módszerrel módosíthatja az alapértelmezett beállításjegyzék-helyet. Az alapértelmezett beállításjegyzék-hely lekéréséhez használja a CWinAppEx::GetRegistryBase.

CWinAppEx::ShowPopupMenu

Előugró menüt jelenít meg.

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

Paraméterek

uiMenuResId
[in] Egy menüerőforrás-azonosító.

point
[in] Egy CPoint, amely meghatározza a menü helyét a képernyő koordinátáiban.

pWnd
[in] Mutató az előugró menüt tartalmazó ablakra.

Visszaadott érték

Nonzero, ha az előugró menü sikeresen megjelenik; 0 egyéb esetben.

Megjegyzések

Ez a metódus megjeleníti a uiMenuResIdtársított menüt.

Az előugró menük támogatásához CContextMenuManager objektummal kell rendelkeznie. Ha még nem inicializálta a CContextMenuManager objektumot, a ShowPopupMenu sikertelen lesz.

CWinAppEx::StoreWindowPlacement

A keretrendszer meghívta a fő keretablak méretét és helyét a beállításjegyzékbe.

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

Paraméterek

nFlags
[in] Jelölők, amelyek a kis méretű ablak pozícióját szabályozzák, valamint azt, hogy az operációs rendszer hogyan vált a kis méretű és a visszaállított ablak között.

nShowCmd
[in] Az ablak megjelenítési állapotát meghatározó egész szám. További információ a lehetséges értékekről: CWnd::ShowWindow.

rectNormalPosition
[in] Egy téglalap, amely a fő keretablak koordinátáit tartalmazza a visszaállított állapotban.

Visszaadott érték

Nonzero, ha sikeres; 0 egyéb esetben.

Megjegyzések

Alapértelmezés szerint az MFC automatikusan menti a fő keretablak pozícióját és állapotát, mielőtt az alkalmazás kilép. Ezeket az adatokat a Rendszer a Windows beállításjegyzékében tárolja az alkalmazás alapértelmezett beállításjegyzék-helyén, a WindowPlacement kulcs alatt. További információ az alkalmazás alapértelmezett beállításjegyzék-helyéről: CWinAppEx::GetRegistryBase.

Bírálja felül ezt a módszert, ha további információkat szeretne tárolni a fő keretablakról.

CWinAppEx::WriteBinary

Bináris adatokat ír a beállításjegyzékbe.

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

Paraméterek

lpszEntry
[in] Egy beállításkulcs nevét tartalmazó sztring.

pData
[in] Az tárolandó adatok.

nBytes
[in] A pData mérete bájtban.

Visszaadott érték

TRUE, hogy ez a módszer sikeres-e; egyéb esetben FALSE.

Megjegyzések

A lpszEntry paraméter az alkalmazás alapértelmezett beállításkulcsában található beállításjegyzék-bejegyzés neve. Az alapértelmezett beállításkulcs lekéréséhez vagy beállításához használja az CWinAppEx::GetRegistryBase és a CWinAppEx::SetRegistryBase metódusokat.

Ha a lpszEntry által megadott kulcs nem létezik, ez a metódus hozza létre.

CWinAppEx::WriteInt

Numerikus adatokat ír a beállításjegyzékbe.

BOOL WriteInt(
    LPCTSTR lpszEntry,
    int nValue);

Paraméterek

lpszEntry
[in] Egy beállításkulcs nevét tartalmazó sztring.

nValue
[in] Az tárolandó adatok.

Visszaadott érték

TRUE, hogy ez a módszer sikeres-e; egyéb esetben FALSE.

Megjegyzések

A lpszEntry paraméter az alkalmazás alapértelmezett beállításkulcsa alatt található beállításjegyzék-bejegyzés neve. Az alapértelmezett beállításkulcs lekéréséhez vagy beállításához használja az CWinAppEx::GetRegistryBase és a CWinAppEx::SetRegistryBase metódusokat.

Ha a lpszEntry által megadott kulcs nem létezik, ez a metódus hozza létre.

CWinAppEx::WriteObject

A CObject osztály származó adatokat ír a beállításjegyzékbe.

BOOL WriteObject(
    LPCTSTR lpszEntry,
    CObject& obj);

Paraméterek

lpszEntry
[in] A beállítandó értéket tartalmazó sztring.

obj
[in] Hivatkozás a metódus által tárolt CObject adatokra.

Visszaadott érték

TRUE, hogy ez a módszer sikeres-e; egyéb esetben FALSE.

Megjegyzések

Ez a metódus az alapértelmezett beállításkulcsban a megadott értékre írja a obj adatokat. Az aktuális beállításkulcs meghatározásához használja a CWinAppEx::GetRegistryBase.

CWinAppEx::WriteSectionBinary

Bináris adatokat ír a beállításjegyzék egy értékére.

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

Paraméterek

lpszSubSection
[in] Egy beállításkulcs nevét tartalmazó sztring

lpszEntry
[in] A beállítandó értéket tartalmazó sztring.

pData
[in] A beállításjegyzékbe írandó adatok.

nBytes
[in] A pData mérete bájtban.

Visszaadott érték

TRUE, hogy ez a módszer sikeres-e; egyéb esetben FALSE.

Megjegyzések

A lpszSubSection paraméter nem a beállításjegyzék-bejegyzés abszolút elérési útja. Ez egy relatív elérési út, amely hozzá van fűzve az alkalmazás alapértelmezett beállításkulcsának végéhez. Az alapértelmezett beállításkulcs lekéréséhez vagy beállításához használja az CWinAppEx::GetRegistryBase és a CWinAppEx::SetRegistryBase metódusokat.

Ha a lpszEntry által megadott kulcs nem létezik, ez a metódus hozza létre.

CWinAppEx::WriteSectionInt

Numerikus adatokat ír a beállításjegyzékbe.

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

Paraméterek

lpszSubSection
[in] Egy beállításkulcs relatív elérési útját tartalmazó sztring.

lpszEntry
[in] A beállítandó értéket tartalmazó sztring.

nValue
[in] A beállításjegyzékbe írandó adatok.

Visszaadott érték

TRUE, hogy ez a módszer sikeres-e; egyéb esetben FALSE.

Megjegyzések

A lpszSubSection paraméter nem egy beállításjegyzék-bejegyzés abszolút elérési útja. Ez egy relatív elérési út, amely hozzá van fűzve az alkalmazás alapértelmezett beállításkulcsához. Az alapértelmezett beállításkulcs lekéréséhez vagy beállításához használja az CWinAppEx::GetRegistryBase és a CWinAppEx::SetRegistryBase metódusokat.

Ha a lpszEntry által megadott kulcs nem létezik, ez a metódus hozza létre.

CWinAppEx::WriteSectionObject

A CObject osztály származó adatokat ír egy adott beállításjegyzék-értékre.

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

Paraméterek

lpszSubSection
[in] Egy beállításkulcs nevét tartalmazó sztring.

lpszEntry
[in] A beállítandó érték nevét tartalmazó sztring.

obj
[in] Az tárolandó adatok.

Visszaadott érték

TRUE, hogy ez a módszer sikeres-e; egyéb esetben FALSE.

Megjegyzések

A lpszSubSection paraméter nem egy beállításjegyzék-bejegyzés abszolút elérési útja. Ez egy relatív elérési út, amely hozzá van fűzve az alkalmazás alapértelmezett beállításkulcsának végéhez. Az alapértelmezett beállításkulcs lekéréséhez vagy beállításához használja a CWinAppEx::GetRegistryBase és a CWinAppEx::SetRegistryBasemetódusokat.

Ha az lpszEntry által megadott érték nem létezik a lpszSubSectionáltal megadott beállításkulcs alatt, ez a metódus létrehozza ezt az értéket.

CWinAppEx::WriteSectionString

Sztringadatokat ír a beállításjegyzék egy értékére.

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

Paraméterek

lpszSubSection
[in] Egy beállításkulcs nevét tartalmazó sztring.

lpszEntry
[in] A beállítandó értéket tartalmazó sztring.

lpszValue
[in] A beállításjegyzékbe írandó sztringadatok.

Visszaadott érték

TRUE, hogy ez a módszer sikeres-e; egyéb esetben FALSE.

Megjegyzések

A lpszSubSection paraméter nem egy beállításjegyzék-bejegyzés abszolút elérési útja. Ez egy relatív elérési út, amely hozzá van fűzve az alkalmazás alapértelmezett beállításkulcsának végéhez. Az alapértelmezett beállításkulcs lekéréséhez vagy beállításához használja a CWinAppEx::GetRegistryBase és a CWinAppEx::SetRegistryBasemetódusokat.

Ha az lpszEntry által megadott érték nem létezik a lpszSubSectionalatt, ez a metódus hozza létre.

CWinAppEx::WriteString

Sztringadatokat ír a beállításjegyzékbe.

BOOL WriteString(
    LPCTSTR lpszEntry,
    LPCTSTR lpszValue);

Paraméterek

lpszEntry
[in] Egy beállításkulcs nevét tartalmazó sztring.

lpszValue
[in] Az tárolandó adatok.

Visszaadott érték

TRUE, hogy ez a módszer sikeres-e; egyéb esetben FALSE.

Megjegyzések

A lpszEntry paraméter az alkalmazás alapértelmezett beállításkulcsa alatt található beállításjegyzék-bejegyzés neve. Az alapértelmezett beállításkulcs lekéréséhez vagy beállításához használja az CWinAppEx::GetRegistryBase és a CWinAppEx::SetRegistryBase metódusokat.

Ha a lspzEntry által megadott kulcs nem létezik, ez a metódus hozza létre.

Lásd még:

hierarchiadiagram
osztályok
CWinApp osztály
CMouseManager osztály
CContextMenuManager osztály
CKeyboardManager osztály
CUserToolsManager osztály