Sdílet prostřednictvím

CMFCCmdUsageCount – třída

  • Článek

Sleduje počet využití zpráv systému Windows, například když uživatel vybere položku z nabídky.

Syntaxe

class CMFCCmdUsageCount : public CObject

Členové

Veřejné konstruktory

Název Popis
CMFCCmdUsageCount::CMFCCmdUsageCount Výchozí konstruktor.
CMFCCmdUsageCount::~CMFCCmdUsageCount Destruktor.

Veřejné metody

Název Popis
CMFCCmdUsageCount::AddCmd Zvýší o jeden čítač přidružený k danému příkazu.
CMFCCmdUsageCount::GetCount Načte počet využití přidružený k danému ID příkazu.
CMFCCmdUsageCount::HasEnoughInformation Určuje, zda tento objekt shromáždil minimální množství sledovacích dat.
CMFCCmdUsageCount::IsFreqeuntlyUsedCmd Určuje, jestli se daný příkaz často používá.
CMFCCmdUsageCount::Reset Vymaže počet využití všech příkazů.
CMFCCmdUsageCount::Serialize Načte tento objekt z archivu nebo ho zapíše do archivu. (Přepsání CObject::Serialize.)
CMFCCmdUsageCount::SetOptions Nastaví hodnoty datových členů sdílené CMFCCmdUsageCount třídy.

Datové členy

Název Popis
m_CmdUsage Objekt CMap , který mapuje příkazy na jejich počty využití.
m_nMinUsagePercentage Minimální procento využití pro příkaz, který se má často používat.
m_nStartCount Spouštěcí čítač, který se používá k určení, zda tento objekt shromáždil minimální množství sledovacích dat.
m_nTotalUsage Počet všechsledovaných

Poznámky

Třída CMFCCmdUsageCount mapuje každý číselný identifikátor zprávy systému Windows na 32bitový celočíselný čítač. CMFCToolBar používá tuto třídu k zobrazení často používaných položek panelu nástrojů. Další informace o CMFCToolBar, viz CMFCToolBar Třída.

Data třídy můžete uchovávat CMFCCmdUsageCount mezi spuštěními programu. K serializaci dat členů třídy a metody CMFCCmdUsageCount::SetOptions použijte metodu CMFCCmdUsageCount::Serialize.

Hierarchie dědičnosti

Objekt CObject

CMFCCmdUsageCount

Požadavky

Hlavička: afxcmdusagecount.h

CMFCCmdUsageCount::AddCmd

Zvýší o jeden čítač přidružený k danému příkazu.

void AddCmd(UINT uiCmd);

Parametry

uiCmd
[v] Určuje čítač příkazu, který se má zvýšit.

Poznámky

Tato metoda přidá novou položku do struktury mapování počtů příkazů , m_CmdUsagepokud položka ještě neexistuje.

Tato metoda nedělá nic v následujících případech:

  • Architektura panelu nástrojů je v režimu přizpůsobení ( CMFCToolBar::IsCustomizeMode metoda vrátí nenulovou hodnotu).

  • Příkaz odkazuje na podnabídku nebo oddělovač nabídek ( uiCmd se rovná 0 nebo -1).

  • uiCmd odkazuje na standardní příkaz (globální IsStandardCommand funkce vrátí nenulovou hodnotu).

CMFCCmdUsageCount::GetCount

Načte počet využití přidružený k danému ID příkazu.

UINT GetCount(UINT uiCmd) const;

Parametry

uiCmd
[v] ID čítače příkazu, který se má načíst.

Návratová hodnota

Počet využití přidružený k danému ID příkazu.

CMFCCmdUsageCount::HasEnoughInformation

Určuje, zda tento objekt obdržel minimální množství sledovacích dat.

BOOL HasEnoughInformation() const;

Návratová hodnota

Nenulové, pokud tento objekt obdržel minimální množství sledovacích dat; jinak 0.

Poznámky

Tato metoda vrátí nenulovou hodnotu, pokud celkový počet , m_nTotalUsage, všechny sledované příkazy jsou rovny nebo větší než počáteční počet, m_nStartCount. Ve výchozím nastavení architektura nastaví počáteční počet 0. Tuto hodnotu můžete přepsat pomocí metody CMFCCmdUsageCount::SetOptions .

Tuto metodu používá CMFCMenuBar::IsShowAllCommands k určení, zda zobrazit všechny dostupné příkazy nabídky.

CMFCCmdUsageCount::IsFreqeuntlyUsedCmd

Určuje, jestli se daný příkaz často používá.

BOOL IsFreqeuntlyUsedCmd(UINT uiCmd) const;

Parametry

uiCmd
[v] Určuje příkaz, který se má zkontrolovat.

Návratová hodnota

Nenulové, pokud je příkaz často používán; jinak 0.

Poznámky

Tato metoda vrátí hodnotu 0, pokud celkové využití příkazů je m_nTotalUsage0. Jinak tato metoda vrátí nenulové, pokud procento, jehož zadaný příkaz je použit, větší než minimální procento, m_nMinUsagePercentage. Ve výchozím nastavení architektura nastaví minimální procento na 5. Tuto hodnotu můžete přepsat pomocí metody CMFCCmdUsageCount::SetOptions . Pokud je minimální procento 0, vrátí tato metoda nenulový, pokud zadaný počet příkazů je větší než 0.

CMFCToolBar::IsCommandRarelyUsed používá tuto metodu k určení, zda je příkaz zřídka používán.

CMFCCmdUsageCount::Reset

Vymaže počet využití všech příkazů.

void Reset();

Poznámky

Voláním této metody vymažete všechny položky ze struktury mapování počtů m_CmdUsagepříkazů a resetuje celkové využití příkazů , m_nTotalUsagečítač na 0.

CMFCCmdUsageCount::Serialize

Načte tento objekt z archivu nebo ho zapíše do archivu.

virtual void Serialize(CArchive& ar);

Parametry

ar
[v] Objekt CArchive pro serializaci z nebo do.

Poznámky

Tato metoda serializuje mapovou strukturu počtů m_CmdUsagepříkazů a celkové využití příkazů, m_nTotalUsagečítače z nebo do zadaného archivu.

Příklady serializace naleznete v tématu Serializace: Serializace objektu.

CMFCCmdUsageCount::SetOptions

Nastaví hodnoty datových členů sdílené CMFCCmdUsageCount třídy.

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

Parametry

nStartCount
[v] Nový počáteční počet všechsledovaných

nMinUsagePercentage
[v] Nové procento minimálního využití.

Návratová hodnota

TRUE Pokud je metoda úspěšná, FALSE pokud nMinUsagePercentage parametr je větší než nebo roven 100.

Poznámky

Tato metoda nastaví datové členy sdílené CMFCCmdUsageCount třídy a m_nMinUsagePercentage nStartCount a nMinUsagePercentage, v uvedeném m_nStartCount pořadí. m_nStartCount používá CMFCCmdUsageCount::HasEnoughInformation metoda k určení, zda tento objekt shromáždil minimální množství sledovacích dat. m_nMinUsagePercentage používá CMFCCmdUsageCount::IsFreqeuntlyUsedCmd metoda k určení, zda daný příkaz je často používán.

V Debug sestaví tuto metodu generuje chybu kontrolního výrazu, pokud nMinUsagePercentage parametr je větší nebo roven 100.

Viz také

Graf hierarchie
Třídy
CMFCToolBar – třída