CMFCCmdUsageCount osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Nyomon követi a Windows-üzenetek használati számát, például amikor a felhasználó kiválaszt egy elemet egy menüből.

Szemantika

class CMFCCmdUsageCount : public CObject

Tagok

Nyilvános konstruktorok

Név	Description
CMFCCmdUsageCount::CMFCCmdUsageCount	Alapértelmezett konstruktor.
CMFCCmdUsageCount::~CMFCCmdUsageCount	Destruktor.

Nyilvános metódusok

Név	Description
CMFCCmdUsageCount::AddCmd	Az adott parancshoz társított számláló eggyel növekszik.
CMFCCmdUsageCount::GetCount	Lekéri a megadott parancsazonosítóhoz társított használatszámot.
CMFCCmdUsageCount::HasEnoughInformation	Meghatározza, hogy ez az objektum összegyűjtötte-e a nyomkövetési adatok minimális mennyiségét.
CMFCCmdUsageCount::IsFreqeuntlyUsedCmd	Meghatározza, hogy gyakran használják-e a megadott parancsot.
CMFCCmdUsageCount::Reset	Törli az összes parancs használati számát.
CMFCCmdUsageCount::Szerializálás	Beolvassa ezt az objektumot egy archívumból, vagy egy archívumba írja. (Felülbírálja a CObject::Serialize parancsot.)
CMFCCmdUsageCount::SetOptions	A megosztott CMFCCmdUsageCount osztály adattagjainak értékeit állítja be.

Adattagok

Név	Description
m_CmdUsage	Egy CMap objektum, amely a parancsokat a használatuk számának megfelelteti.
m_nMinUsagePercentage	A gyakran használt parancsok minimális használati aránya.
m_nStartCount	A kezdőszámláló, amely annak meghatározására szolgál, hogy az objektum összegyűjtötte-e a minimális nyomkövetési adatokat.
m_nTotalUsage	Az összes követett parancs száma.

Megjegyzések

Az CMFCCmdUsageCount osztály minden numerikus Windows-üzenetazonosítót egy 32 bites aláíratlan egész számszámlálóra képez le. CMFCToolBar ezzel az osztályral jeleníti meg a gyakran használt eszköztárelemeket. További információ: CMFCToolBarCMFCToolBar osztály.

A program futtatásai között megőrizheti CMFCCmdUsageCount az osztályadatokat. A CMFCCmdUsageCount::Serialize metódussal szerializálhatja az osztálytagok adatait, és a CMFCCmdUsageCount::SetOptions metódust a megosztott tagok adatainak beállításához.

Öröklési hierarchia

CObject

CMFCCmdUsageCount

Requirements

Fejléc: afxcmdusagecount.h

CMFCCmdUsageCount::AddCmd

Az adott parancshoz társított számláló eggyel növekszik.

void AddCmd(UINT uiCmd);

Paraméterek

uiCmd
[in] A növekményes parancsszámlálót adja meg.

Megjegyzések

Ez a metódus új bejegyzést ad hozzá a parancsok számának térképszerkezetéhez, m_CmdUsageha a bejegyzés még nem létezik.

Ez a módszer a következő esetekben nem végez semmit:

• Az eszköztár-keretrendszer testreszabási módban van (a CMFCToolBar::IsCustomizeMode metódus nemzero értéket ad vissza).

• A parancs egy almenüre vagy menüelválasztóra hivatkozik ( uiCmd értéke 0 vagy -1).

• Az uiCmd egy standard parancsra hivatkozik (a globális IsStandardCommand függvény nemero értéket ad vissza).

CMFCCmdUsageCount::GetCount

Lekéri a megadott parancsazonosítóhoz társított használatszámot.

UINT GetCount(UINT uiCmd) const;

Paraméterek

uiCmd
[in] A lekérni kívánt parancsszámláló azonosítója.

Visszaadott érték

A megadott parancsazonosítóhoz társított használat száma.

CMFCCmdUsageCount::HasEnoughInformation

Meghatározza, hogy az objektum megkapta-e a minimális nyomkövetési adatokat.

BOOL HasEnoughInformation() const;

Visszaadott érték

Nonzero, ha ez az objektum megkapta a minimális nyomkövetési adatokat; egyéb esetben 0.

Megjegyzések

Ez a metódus nemero értéket ad vissza, m_nTotalUsageha az összes követett parancs teljes száma egyenlő vagy nagyobb, mint a kezdeti szám. m_nStartCount Alapértelmezés szerint a keretrendszer a kezdeti szám 0-t állítja be. Ezt az értéket felülbírálhatja a CMFCCmdUsageCount::SetOptions metódussal.

Ezt a metódust használja a CMFCMenuBar::IsShowAllCommands annak meghatározására, hogy az összes elérhető menüparancs megjelenjen-e.

CMFCCmdUsageCount::IsFreqeuntlyUsedCmd

Meghatározza, hogy gyakran használják-e a megadott parancsot.

BOOL IsFreqeuntlyUsedCmd(UINT uiCmd) const;

Paraméterek

uiCmd
[in] Megadja az ellenőrizni kívánt parancsot.

Visszaadott érték

Nemzero, ha a parancsot gyakran használják; egyéb esetben 0.

Megjegyzések

Ez a metódus 0 értéket ad vissza, m_nTotalUsageha a parancs teljes használata 0. Ellenkező esetben ez a metódus nonzero értéket ad vissza, ha a megadott parancsot használó százalék nagyobb, mint a minimális százalék. m_nMinUsagePercentage Alapértelmezés szerint a keretrendszer a minimális százalékot 5-re állítja. Ezt az értéket felülbírálhatja a CMFCCmdUsageCount::SetOptions metódussal. Ha a minimális százalékérték 0, akkor ez a metódus nem 0 értéket ad vissza, ha a megadott parancsok száma 0-nál nagyobb.

CMFCToolBar::IsCommandRarelyUsed ezzel a módszerrel állapítja meg, hogy ritkán használ-e parancsot.

CMFCCmdUsageCount::Reset

Törli az összes parancs használati számát.

void Reset();

Megjegyzések

Ennek a metódusnak a meghívásával törölheti az összes bejegyzést a parancsok számának leképezési szerkezetéből, m_CmdUsageés visszaállíthatja a teljes parancshasználatot m_nTotalUsage0-ra.

CMFCCmdUsageCount::Szerializálás

Beolvassa ezt az objektumot egy archívumból, vagy egy archívumba írja.

virtual void Serialize(CArchive& ar);

Paraméterek

Ar
[in] Egy CArchive objektum, amelyből szerializálni szeretne.

Megjegyzések

Ez a metódus szerializálja a parancsok számának térképszerkezetét, m_CmdUsagevalamint a parancsok teljes használatát, m_nTotalUsagea számlálót a megadott archívumból vagy a megadott archívumba.

Szerializálási példákért lásd : Szerializálás: Objektum szerializálása.

CMFCCmdUsageCount::SetOptions

A megosztott CMFCCmdUsageCount osztály adattagjainak értékeit állítja be.

static BOOL __stdcall SetOptions(
    UINT nStartCount,
    UINT nMinUsagePercentage);

Paraméterek

nStartCount
[in] Az összes követett parancs új kezdeti száma.

nMinUsagePercentage
[in] Az új minimális használati százalék.

Visszaadott érték

IGAZ, ha a metódus sikeres, HAMIS, ha az nMinUsagePercentage paraméter nagyobb vagy egyenlő 100-nál.

Megjegyzések

Ez a metódus beállítja a megosztott CMFCCmdUsageCount osztály adattagjait m_nStartCount , valamint m_nMinUsagePercentage az nStartCount és az nMinUsagePercentage értéket. m_nStartCount A CMFCCmdUsageCount::HasEnoughInformation metódus azt határozza meg, hogy ez az objektum összegyűjtötte-e a nyomkövetési adatok minimális mennyiségét. m_nMinUsagePercentage A CMFCCmdUsageCount::IsFreqeuntlyUsedCmd metódussal állapítható meg, hogy gyakran használ-e egy adott parancsot.

A Hibakeresési buildekben ez a metódus érvényesítési hibát okoz, ha az nMinUsagePercentage paraméter nagyobb vagy egyenlő 100-nál.

Lásd még

hierarchiadiagram
osztályok
CMFCToolBar osztály