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

Metodi pubblici

Membri dei dati

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à

CObject

CMFCCmdUsageCount

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 IsStandardCommand restituisce 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.

Vedi anche

Grafico della gerarchia
Classi
Classe CMFCToolBar