Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of mappen te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen om mappen te wijzigen.
Opmerking
De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.
Houdt het aantal windows-berichten bij, bijvoorbeeld wanneer de gebruiker een item in een menu selecteert.
Syntaxis
class CMFCCmdUsageCount : public CObject
Leden
Openbare constructors
| Naam | Description |
|---|---|
CMFCCmdUsageCount::CMFCCmdUsageCount |
Standaardconstructor. |
CMFCCmdUsageCount::~CMFCCmdUsageCount |
Destructor. |
Openbare methoden
| Naam | Description |
|---|---|
| CMFCCmdUsageCount::AddCmd | Hiermee wordt één teller verhoogd die is gekoppeld aan de opgegeven opdracht. |
| CMFCCmdUsageCount::GetCount | Hiermee haalt u het gebruiksaantal op dat is gekoppeld aan de opgegeven opdracht-id. |
| CMFCCmdUsageCount::HasEnoughInformation | Bepaalt of dit object de minimale hoeveelheid traceringsgegevens heeft verzameld. |
| CMFCCmdUsageCount::IsFreqeuntlyUsedCmd | Bepaalt of de opgegeven opdracht vaak wordt gebruikt. |
| CMFCCmdUsageCount::Reset | Hiermee wist u het aantal gebruiksgegevens van alle opdrachten. |
| CMFCCmdUsageCount::Serialize | Leest dit object uit een archief of schrijft het naar een archief. (Overschrijft CObject::Serialize.) |
| CMFCCmdUsageCount::SetOptions | Hiermee stelt u de waarden van gedeelde CMFCCmdUsageCount klassegegevensleden in. |
Gegevensleden
| Naam | Description |
|---|---|
m_CmdUsage |
Een CMap object waarmee opdrachten worden toegewezen aan het aantal gebruiksgegevens. |
m_nMinUsagePercentage |
Het minimale gebruikspercentage voor een opdracht die vaak moet worden gebruikt. |
m_nStartCount |
De beginteller die wordt gebruikt om te bepalen of dit object de minimale hoeveelheid traceringsgegevens heeft verzameld. |
m_nTotalUsage |
Het aantal bijgehouden opdrachten. |
Opmerkingen
De CMFCCmdUsageCount klasse wijst elke numerieke Windows-bericht-id toe aan een 32-bits niet-ondertekende geheel getalteller.
CMFCToolBar gebruikt deze klasse om veelgebruikte werkbalkitems weer te geven. Zie CMFCToolBar Class voor meer informatie.CMFCToolBar
U kunt klassegegevens tussen uitvoeringen van uw programma behouden CMFCCmdUsageCount . Gebruik de methode CMFCCmdUsageCount::Serialize om klasselidgegevens en de methode CMFCCmdUsageCount::SetOptions te serialiseren om gedeelde lidgegevens in te stellen.
Overnamehiërarchie
Requirements
Koptekst: afxcmdusagecount.h
CMFCCmdUsageCount::AddCmd
Hiermee wordt één teller verhoogd die is gekoppeld aan de opgegeven opdracht.
void AddCmd(UINT uiCmd);
Parameterwaarden
uiCmd
[in] Hiermee geeft u de opdrachtteller te verhogen.
Opmerkingen
Met deze methode wordt een nieuwe vermelding toegevoegd aan de toewijzingsstructuur van het aantal opdrachten, m_CmdUsageals de vermelding nog niet bestaat.
Deze methode doet niets in de volgende gevallen:
Het werkbalkframework bevindt zich in de aanpassingsmodus (de methode CMFCToolBar::IsCustomizeMode retourneert een niet-nulwaarde).
De opdracht verwijst naar een submenu of menuscheidingsteken ( uiCmd is gelijk aan 0 of -1).
uiCmd verwijst naar een standaardopdracht (de globale
IsStandardCommandfunctie retourneert een niet-nulwaarde).
CMFCCmdUsageCount::GetCount
Hiermee haalt u het gebruiksaantal op dat is gekoppeld aan de opgegeven opdracht-id.
UINT GetCount(UINT uiCmd) const;
Parameterwaarden
uiCmd
[in] De id van de opdrachtteller die moet worden opgehaald.
Retourwaarde
Het gebruiksaantal dat is gekoppeld aan de opgegeven opdracht-id.
CMFCCmdUsageCount::HasEnoughInformation
Bepaalt of dit object de minimale hoeveelheid traceringsgegevens heeft ontvangen.
BOOL HasEnoughInformation() const;
Retourwaarde
Niet-nul als dit object de minimale hoeveelheid traceringsgegevens heeft ontvangen; anders 0.
Opmerkingen
Deze methode retourneert een niet-nulwaarde als het totale aantal, m_nTotalUsagevan alle bijgehouden opdrachten gelijk is aan of groter is dan het eerste aantal, m_nStartCount. Standaard stelt het framework het eerste aantal 0 in. U kunt deze waarde overschrijven met behulp van de methode CMFCCmdUsageCount::SetOptions .
Deze methode wordt gebruikt door CMFCMenuBar::IsShowAllCommands om te bepalen of alle beschikbare menuopdrachten moeten worden weergegeven.
CMFCCmdUsageCount::IsFreqeuntlyUsedCmd
Bepaalt of de opgegeven opdracht vaak wordt gebruikt.
BOOL IsFreqeuntlyUsedCmd(UINT uiCmd) const;
Parameterwaarden
uiCmd
[in] Hiermee geeft u de opdracht te controleren.
Retourwaarde
Niet-nul als de opdracht vaak wordt gebruikt; anders 0.
Opmerkingen
Deze methode retourneert 0 als het totale gebruik van de opdracht, m_nTotalUsage0 is. Anders retourneert deze methode niet-nul als het percentage waarvan de opgegeven opdracht wordt gebruikt groter is dan het minimumpercentage. m_nMinUsagePercentage Standaard stelt het framework het minimumpercentage in op 5. U kunt deze waarde overschrijven met behulp van de methode CMFCCmdUsageCount::SetOptions . Als het minimumpercentage 0 is, retourneert deze methode niet-nul als het opgegeven aantal opdrachten groter is dan 0.
CMFCToolBar::IsCommandRarelyUsed gebruikt deze methode om te bepalen of een opdracht zelden wordt gebruikt.
CMFCCmdUsageCount::Reset
Hiermee wist u het aantal gebruiksgegevens van alle opdrachten.
void Reset();
Opmerkingen
Roep deze methode aan om alle vermeldingen uit de toewijzingsstructuur van het aantal opdrachten te wissen, m_CmdUsageen om het totale opdrachtgebruik opnieuw in te stellen, m_nTotalUsageteller op 0.
CMFCCmdUsageCount::Serialize
Leest dit object uit een archief of schrijft het naar een archief.
virtual void Serialize(CArchive& ar);
Parameterwaarden
Ar
[in] Een CArchive object dat moet worden geserialiseerd van of naar.
Opmerkingen
Deze methode serialiseert de kaartstructuur van het aantal opdrachten, m_CmdUsageen het totale opdrachtgebruik, m_nTotalUsageteller van of naar het opgegeven archief.
Zie Serialisatie: Een object serialiseren voor voorbeelden van serialisatie.
CMFCCmdUsageCount::SetOptions
Hiermee stelt u de waarden van gedeelde CMFCCmdUsageCount klassegegevensleden in.
static BOOL __stdcall SetOptions(
UINT nStartCount,
UINT nMinUsagePercentage);
Parameterwaarden
nStartCount
[in] Het nieuwe aantal bijgehouden opdrachten.
nMinUsagePercentage
[in] Het nieuwe minimumgebruikspercentage.
Retourwaarde
TRUE als de methode slaagt, FALSE als de parameter nMinUsagePercentage groter is dan of gelijk is aan 100.
Opmerkingen
Met deze methode worden de gedeelde CMFCCmdUsageCount klassegegevensleden m_nStartCount en m_nMinUsagePercentagerespectievelijk nStartCount en nMinUsagePercentage ingesteld.
m_nStartCount wordt gebruikt door de CMFCCmdUsageCount::HasEnoughInformation-methode om te bepalen of dit object de minimale hoeveelheid traceringsgegevens heeft verzameld.
m_nMinUsagePercentage wordt gebruikt door de methode CMFCCmdUsageCount::IsFreqeuntlyUsedCmd om te bepalen of een bepaalde opdracht vaak wordt gebruikt.
In Foutopsporing wordt met deze methode een assertiefout gegenereerd als de parameter nMinUsagePercentage groter is dan of gelijk is aan 100.