CMFCCmdUsageCount-Klasse

Verfolgt die Verwendungsanzahl von Windows-Nachrichten nach, z. B. wenn der Benutzer ein Element aus einem Menü auswählt.

Syntax

class CMFCCmdUsageCount : public CObject

Member

Öffentliche Konstruktoren

Name	Beschreibung
CMFCCmdUsageCount::CMFCCmdUsageCount	Der Standardkonstruktor.
CMFCCmdUsageCount::~CMFCCmdUsageCount	Destruktor.

Öffentliche Methoden

Name	Beschreibung
CMFCCmdUsageCount::AddCmd	Erhöht sich um einen der Zähler, der dem angegebenen Befehl zugeordnet ist.
CMFCCmdUsageCount::GetCount	Ruft die Verwendungsanzahl ab, die der angegebenen Befehls-ID zugeordnet ist.
CMFCCmdUsageCount::HasEnoughInformation	Bestimmt, ob dieses Objekt die Mindestmenge der Nachverfolgungsdaten erfasst hat.
CMFCCmdUsageCount::IsFreqeuntlyUsedCmd	Bestimmt, ob der angegebene Befehl häufig verwendet wird.
CMFCCmdUsageCount::Reset	Löscht die Verwendungsanzahl aller Befehle.
CMFCCmdUsageCount::Serialize	Liest dieses Objekt aus einem Archiv oder schreibt es in ein Archiv. (Überschreibt CObject::Serialize.)
CMFCCmdUsageCount::SetOptions	Legt die Werte freigegebener CMFCCmdUsageCount Klassendatenmember fest.

Datenelemente

Name	Beschreibung
m_CmdUsage	Ein CMap Objekt, das Befehle ihrer Verwendungsanzahl zuordnet.
m_nMinUsagePercentage	Der Mindestverbrauchsprozentsatz für einen Befehl, der häufig verwendet werden soll.
m_nStartCount	Der Startzähler, der verwendet wird, um zu bestimmen, ob dieses Objekt die Mindestmenge der Nachverfolgungsdaten erfasst hat.
m_nTotalUsage	Die Anzahl aller nachverfolgten Befehle.

Hinweise

Die CMFCCmdUsageCount Klasse ordnet jeden numerischen Windows-Nachrichtenbezeichner einem 32-Bit-Zähler für nicht signierte ganzzahlige Zahlen zu. CMFCToolBar verwendet diese Klasse, um häufig verwendete Symbolleistenelemente anzuzeigen. Weitere Informationen CMFCToolBarfinden Sie unter CMFCToolBar Class.

Sie können Klassendaten zwischen Denläufen Ihres Programms beibehalten CMFCCmdUsageCount . Verwenden Sie die CMFCCmdUsageCount::Serialize-Methode zum Serialisieren von Klassenmemmemmdaten und der CMFCCmdUsageCount::SetOptions-Methode , um freigegebene Memberdaten festzulegen.

Vererbungshierarchie

CObject

CMFCCmdUsageCount

Anforderungen

Header: afxcmdusagecount.h

CMFCCmdUsageCount::AddCmd

Erhöht sich um einen der Zähler, der dem angegebenen Befehl zugeordnet ist.

void AddCmd(UINT uiCmd);

Parameter

uiCmd
[in] Gibt den Befehlszähler an, der erhöht werden soll.

Hinweise

Diese Methode fügt der Zuordnungsstruktur der Befehlsanzahl einen neuen Eintrag hinzu, m_CmdUsagewenn der Eintrag noch nicht vorhanden ist.

Diese Methode führt in den folgenden Fällen nichts aus:

• Das Symbolleistenframework befindet sich im Anpassungsmodus (die CMFCToolBar::IsCustomizeMode-Methode gibt einen Wert ungleich Null zurück).

• Der Befehl bezieht sich auf ein Untermenü- oder Menütrennzeichen ( uiCmd entspricht 0 oder -1).

• uiCmd bezieht sich auf einen Standardbefehl (die globale IsStandardCommand Funktion gibt einen Wert ungleich Null zurück).

CMFCCmdUsageCount::GetCount

Ruft die Verwendungsanzahl ab, die der angegebenen Befehls-ID zugeordnet ist.

UINT GetCount(UINT uiCmd) const;

Parameter

uiCmd
[in] Die ID des abzurufenden Befehlszählers.

Rückgabewert

Die Verwendungsanzahl, die der angegebenen Befehls-ID zugeordnet ist.

CMFCCmdUsageCount::HasEnoughInformation

Bestimmt, ob dieses Objekt die Mindestmenge der Nachverfolgungsdaten erhalten hat.

BOOL HasEnoughInformation() const;

Rückgabewert

Nonzero, wenn dieses Objekt die Mindestmenge an Tracking-Daten erhalten hat; andernfalls 0.

Hinweise

Diese Methode gibt einen Wert ungleich Null zurück, m_nTotalUsagewenn die Gesamtzahl aller nachverfolgten Befehle gleich oder größer als die anfängliche Anzahl m_nStartCountist. Standardmäßig legt das Framework die anfängliche Anzahl 0 fest. Sie können diesen Wert mithilfe der CMFCCmdUsageCount::SetOptions-Methode überschreiben.

Diese Methode wird von CMFCMenuBar::IsShowAllCommands verwendet, um zu bestimmen, ob alle verfügbaren Menübefehle angezeigt werden sollen.

CMFCCmdUsageCount::IsFreqeuntlyUsedCmd

Bestimmt, ob der angegebene Befehl häufig verwendet wird.

BOOL IsFreqeuntlyUsedCmd(UINT uiCmd) const;

Parameter

uiCmd
[in] Gibt den zu überprüfenden Befehl an.

Rückgabewert

Nonzero, wenn der Befehl häufig verwendet wird; andernfalls 0.

Hinweise

Diese Methode gibt 0 zurück, m_nTotalUsagewenn die Gesamtnutzung des Befehls 0 ist. Andernfalls gibt diese Methode "nonzero" zurück, wenn der Prozentsatz, von dem der angegebene Befehl verwendet wird, größer als der Mindestprozentsatz m_nMinUsagePercentageist. Standardmäßig legt das Framework den Minimalprozentsatz auf 5 fest. Sie können diesen Wert mithilfe der CMFCCmdUsageCount::SetOptions-Methode überschreiben. Wenn der Mindestprozentsatz 0 ist, gibt diese Methode einen Wert ungleich Null zurück, wenn die angegebene Befehlsanzahl größer als 0 ist.

CMFCToolBar::IsCommandRarelyUsed verwendet diese Methode, um zu bestimmen, ob ein Befehl selten verwendet wird.

CMFCCmdUsageCount::Reset

Löscht die Verwendungsanzahl aller Befehle.

void Reset();

Hinweise

Rufen Sie diese Methode auf, um alle Einträge aus der Zuordnungsstruktur der Befehlsanzahl zu löschen, m_CmdUsageund um die Gesamtnutzung des Befehls zurückzusetzen, m_nTotalUsageZähler auf 0.

CMFCCmdUsageCount::Serialize

Liest dieses Objekt aus einem Archiv oder schreibt es in ein Archiv.

virtual void Serialize(CArchive& ar);

Parameter

Ar
[in] Ein CArchive Objekt, das von oder nach serialisiert werden soll.

Hinweise

Diese Methode serialisiert die Zuordnungsstruktur der Befehlsanzahl, m_CmdUsageund die Gesamtnutzung des Befehls, m_nTotalUsagedes Zählers von oder zum angegebenen Archiv.

Beispiele für die Serialisierung finden Sie unter Serialisierung: Serialisieren eines Objekts.

CMFCCmdUsageCount::SetOptions

Legt die Werte freigegebener CMFCCmdUsageCount Klassendatenmember fest.

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

Parameter

nStartCount
[in] Die neue Anfangsanzahl aller nachverfolgten Befehle.

nMinUsagePercentage
[in] Der neue Mindestnutzungsprozentsatz.

Rückgabewert

TRUE, wenn die Methode erfolgreich ist, FALSE, wenn der Parameter nMinUsagePercentage größer oder gleich 100 ist.

Hinweise

Mit dieser Methode werden die freigegebenen CMFCCmdUsageCount Klassendatenmember m_nStartCount bzw. nStartCount und m_nMinUsagePercentagenMinUsagePercentage festgelegt. m_nStartCount wird von der CMFCCmdUsageCount::HasEnoughInformation-Methode verwendet, um zu bestimmen, ob dieses Objekt die Mindestmenge der Nachverfolgungsdaten erfasst hat. m_nMinUsagePercentage wird von der CMFCCmdUsageCount::IsFreqeuntlyUsedCmd-Methode verwendet, um zu bestimmen, ob ein bestimmter Befehl häufig verwendet wird.

In Debugbuilds generiert diese Methode einen Assertionsfehler, wenn der nMinUsagePercentage-Parameter größer oder gleich 100 ist.

Siehe auch

Hierarchiediagramm
Klassen
CMFCToolBar-Klasse