Classe CMFCCmdUsageCount
Tiene traccia del numero di utilizzo dei messaggi di Windows, ad esempio quando l'utente seleziona una voce da un menu.
Sintassi
class CMFCCmdUsageCount : public CObject
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
CMFCCmdUsageCount::CMFCCmdUsageCount |
Costruttore predefinito. |
CMFCCmdUsageCount::~CMFCCmdUsageCount |
Distruttore. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CMFCCmdUsageCount::AddCmd | Incrementa di un contatore associato al comando specificato. |
| CMFCCmdUsageCount::GetCount | Recupera il conteggio di utilizzo associato all'ID del comando specificato. |
| CMFCCmdUsageCount::HasEnoughInformation | Determina se questo oggetto ha raccolto la quantità minima di dati di rilevamento. |
| CMFCCmdUsageCount::IsFreqeuntlyUsedCmd | Determina se il comando specificato viene usato di frequente. |
| CMFCCmdUsageCount::Reset | Cancella il numero di utilizzo di tutti i comandi. |
| CMFCCmdUsageCount::Serialize | Legge questo oggetto da un archivio o lo scrive in un archivio. Esegue l'override di CObject::Serialize. |
| CMFCCmdUsageCount::SetOptions | Imposta i valori dei membri dati della classe condivisa CMFCCmdUsageCount . |
Membri dei dati
| Nome | Descrizione |
|---|---|
m_CmdUsage |
Oggetto CMap che esegue il mapping dei comandi ai relativi conteggi di utilizzo. |
m_nMinUsagePercentage |
Percentuale di utilizzo minima per un comando da usare di frequente. |
m_nStartCount |
Contatore iniziale utilizzato per determinare se questo oggetto ha raccolto la quantità minima di dati di rilevamento. |
m_nTotalUsage |
Conteggio di tutti i comandi rilevati. |
Osservazioni:
La classe esegue il CMFCCmdUsageCount mapping di ogni identificatore numerico del messaggio di Windows a un contatore intero senza segno a 32 bit. CMFCToolBar usa questa classe per visualizzare gli elementi della barra degli strumenti usati di frequente. Per altre informazioni su CMFCToolBar, vedere Classe CMFCToolBar.
È possibile rendere persistenti CMFCCmdUsageCount i dati della classe tra le esecuzioni del programma. Utilizzare il metodo CMFCCmdUsageCount::Serialize per serializzare i dati dei membri della classe e il metodo CMFCCmdUsageCount::SetOptions per impostare i dati dei membri condivisi.
Gerarchia di ereditarietà
Requisiti
Intestazione: afxcmdusagecount.h
CMFCCmdUsageCount::AddCmd
Incrementa di un contatore associato al comando specificato.
void AddCmd(UINT uiCmd);
Parametri
uiCmd
[in] Specifica il contatore dei comandi da incrementare.
Osservazioni:
Questo metodo aggiunge una nuova voce alla struttura della mappa dei conteggi dei comandi, , m_CmdUsagese la voce non esiste già.
Questo metodo non esegue alcuna operazione nei casi seguenti:
Il framework della barra degli strumenti è in modalità di personalizzazione (il metodo CMFCToolBar::IsCustomizeMode restituisce un valore diverso da zero).
Il comando fa riferimento a un sottomenu o a un separatore di menu ( uiCmd è uguale a 0 o -1).
uiCmd fa riferimento a un comando standard (la funzione globale
IsStandardCommandrestituisce un valore diverso da zero).
CMFCCmdUsageCount::GetCount
Recupera il conteggio di utilizzo associato all'ID del comando specificato.
UINT GetCount(UINT uiCmd) const;
Parametri
uiCmd
[in] ID del contatore dei comandi da recuperare.
Valore restituito
Numero di utilizzo associato all'ID del comando specificato.
CMFCCmdUsageCount::HasEnoughInformation
Determina se l'oggetto ha ricevuto la quantità minima di dati di rilevamento.
BOOL HasEnoughInformation() const;
Valore restituito
Diverso da zero se questo oggetto ha ricevuto la quantità minima di dati di rilevamento; in caso contrario, 0.
Osservazioni:
Questo metodo restituisce un valore diverso da zero se il conteggio totale, m_nTotalUsage, di tutti i comandi rilevati è uguale o maggiore del conteggio iniziale, m_nStartCount. Per impostazione predefinita, il framework imposta il conteggio iniziale 0. È possibile eseguire l'override di questo valore usando il metodo CMFCCmdUsageCount::SetOptions .
Questo metodo viene usato da CMFCMenuBar::IsShowAllCommands per determinare se visualizzare tutti i comandi di menu disponibili.
CMFCCmdUsageCount::IsFreqeuntlyUsedCmd
Determina se il comando specificato viene usato di frequente.
BOOL IsFreqeuntlyUsedCmd(UINT uiCmd) const;
Parametri
uiCmd
[in] Specifica il comando da controllare.
Valore restituito
Diverso da zero se il comando viene usato di frequente; in caso contrario, 0.
Osservazioni:
Questo metodo restituisce 0 se l'utilizzo totale dei comandi, m_nTotalUsage, è 0. In caso contrario, questo metodo restituisce un valore diverso da zero se la percentuale di utilizzo del comando specificato è maggiore della percentuale minima, m_nMinUsagePercentage. Per impostazione predefinita, il framework imposta la percentuale minima su 5. È possibile eseguire l'override di questo valore usando il metodo CMFCCmdUsageCount::SetOptions . Se la percentuale minima è 0, questo metodo restituisce un valore diverso da zero se il numero di comandi specificato è maggiore di 0.
CMFCToolBar::IsCommandRarelyUsed usa questo metodo per determinare se un comando viene usato raramente.
CMFCCmdUsageCount::Reset
Cancella il numero di utilizzo di tutti i comandi.
void Reset();
Osservazioni:
Chiamare questo metodo per cancellare tutte le voci dalla struttura della mappa dei conteggi dei comandi, m_CmdUsagee per reimpostare l'utilizzo totale dei comandi, m_nTotalUsage, il contatore su 0.
CMFCCmdUsageCount::Serialize
Legge questo oggetto da un archivio o lo scrive in un archivio.
virtual void Serialize(CArchive& ar);
Parametri
Ar
[in] Oggetto CArchive da cui eseguire la serializzazione da o a.
Osservazioni:
Questo metodo serializza la struttura della mappa dei conteggi dei comandi, m_CmdUsagee l'utilizzo totale dei comandi, , m_nTotalUsageil contatore da o nell'archivio specificato.
Per esempi di serializzazione, vedere Serializzazione: Serializzazione di un oggetto.
CMFCCmdUsageCount::SetOptions
Imposta i valori dei membri dati della classe condivisa CMFCCmdUsageCount .
static BOOL __stdcall SetOptions(
UINT nStartCount,
UINT nMinUsagePercentage);
Parametri
nStartCount
[in] Nuovo conteggio iniziale di tutti i comandi rilevati.
nMinUsagePercentage
[in] Nuova percentuale di utilizzo minima.
Valore restituito
TRUE se il metodo ha esito positivo, FALSE se il parametro nMinUsagePercentage è maggiore o uguale a 100.
Osservazioni:
Questo metodo imposta i membri dati della classe condivisa CMFCCmdUsageCount e m_nMinUsagePercentage rispettivamente su nStartCount e nMinUsagePercentage.m_nStartCount m_nStartCount viene utilizzato dal metodo CMFCCmdUsageCount::HasEnoughInformation per determinare se questo oggetto ha raccolto la quantità minima di dati di rilevamento. m_nMinUsagePercentage viene usato dal metodo CMFCCmdUsageCount::IsFreqeuntlyUsedCmd per determinare se un determinato comando viene usato di frequente.
In Debug compila questo metodo genera un errore di asserzione se il parametro nMinUsagePercentage è maggiore o uguale a 100.