Freigeben über

CMFCCmdUsageCount-Klasse

  • Artikel

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_nMinUsagePercentage nMinUsagePercentage 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