Klasa CMFCCmdUsageCount

Śledzi liczbę użycia komunikatów systemu Windows, na przykład gdy użytkownik wybierze element z menu.

Składnia

class CMFCCmdUsageCount : public CObject

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
CMFCCmdUsageCount::CMFCCmdUsageCount	Konstruktor domyślny.
CMFCCmdUsageCount::~CMFCCmdUsageCount	Destruktor.

Metody publiczne

Nazwa/nazwisko	opis
CMFCCmdUsageCount::AddCmd	Zwiększa się o jeden licznik skojarzony z danym poleceniem.
CMFCCmdUsageCount::GetCount	Pobiera liczbę użycia skojarzona z danym identyfikatorem polecenia.
CMFCCmdUsageCount::HasEnoughInformation	Określa, czy ten obiekt zebrał minimalną ilość danych śledzenia.
CMFCCmdUsageCount::IsFreqeuntlyUsedCmd	Określa, czy dane polecenie jest często używane.
CMFCCmdUsageCount::Reset	Czyści liczbę użycia wszystkich poleceń.
CMFCCmdUsageCount::Serialize	Odczytuje ten obiekt z archiwum lub zapisuje go w archiwum. (Przesłonięcia) CObject::Serialize.)
CMFCCmdUsageCount::SetOptions	Ustawia wartości współużytkowanych CMFCCmdUsageCount składowych danych klasy.

Składowe danych

Nazwa/nazwisko	opis
m_CmdUsage	CMap Obiekt, który mapuje polecenia na ich liczniki użycia.
m_nMinUsagePercentage	Minimalna wartość procentowa użycia polecenia, która ma być często używana.
m_nStartCount	Licznik uruchamiania używany do określania, czy ten obiekt zebrał minimalną ilość danych śledzenia.
m_nTotalUsage	Liczba wszystkich śledzonych poleceń.

Uwagi

Klasa CMFCCmdUsageCount mapuje każdy numeryczny identyfikator komunikatu systemu Windows na 32-bitowy niepodpisany licznik liczb całkowitych. CMFCToolBar używa tej klasy do wyświetlania często używanych elementów paska narzędzi. Aby uzyskać więcej informacji na temat CMFCToolBarprogramu , zobacz Klasa CMFCToolBar.

Dane klas można utrwalać CMFCCmdUsageCount między przebiegami programu. Użyj metody CMFCCmdUsageCount::Serialize, aby serializować dane składowych klasy i metodę CMFCCmdUsageCount::SetOptions, aby ustawić udostępnione dane składowe.

Hierarchia dziedziczenia

Obiekt CObject

CMFCCmdUsageCount

Wymagania

Nagłówek: afxcmdusagecount.h

CMFCCmdUsageCount::AddCmd

Zwiększa się o jeden licznik skojarzony z danym poleceniem.

void AddCmd(UINT uiCmd);

Parametry

uiCmd
[in] Określa licznik poleceń, aby zwiększać.

Uwagi

Ta metoda dodaje nowy wpis do struktury mapowania liczby poleceń, m_CmdUsage, jeśli wpis jeszcze nie istnieje.

Ta metoda nie wykonuje żadnych czynności w następujących przypadkach:

• Struktura paska narzędzi jest w trybie dostosowywania ( metoda CMFCToolBar::IsCustomizeMode zwraca wartość niezerową).

• Polecenie odwołuje się do separatora podmenu lub menu ( uiCmd równa się 0 lub -1).

• uiCmd odwołuje się do standardowego polecenia (funkcja globalna IsStandardCommand zwraca wartość niezerową).

CMFCCmdUsageCount::GetCount

Pobiera liczbę użycia skojarzona z danym identyfikatorem polecenia.

UINT GetCount(UINT uiCmd) const;

Parametry

uiCmd
[in] Identyfikator licznika poleceń do pobrania.

Wartość zwracana

Liczba użycia skojarzona z danym identyfikatorem polecenia.

CMFCCmdUsageCount::HasEnoughInformation

Określa, czy ten obiekt otrzymał minimalną ilość danych śledzenia.

BOOL HasEnoughInformation() const;

Wartość zwracana

Nonzero, jeśli ten obiekt otrzymał minimalną ilość danych śledzenia; w przeciwnym razie 0.

Uwagi

Ta metoda zwraca wartość niezerową, jeśli łączna liczba, m_nTotalUsage, wszystkich śledzonych poleceń jest równa lub większa niż początkowa liczba. m_nStartCount Domyślnie platforma ustawia początkową liczbę 0. Tę wartość można zastąpić przy użyciu metody CMFCCmdUsageCount::SetOptions .

Ta metoda jest używana przez CMFCMenuBar::IsShowAllCommands w celu określenia, czy mają być wyświetlane wszystkie dostępne polecenia menu.

CMFCCmdUsageCount::IsFreqeuntlyUsedCmd

Określa, czy dane polecenie jest często używane.

BOOL IsFreqeuntlyUsedCmd(UINT uiCmd) const;

Parametry

uiCmd
[in] Określa polecenie do sprawdzenia.

Wartość zwracana

Nonzero, jeśli polecenie jest często używane; w przeciwnym razie 0.

Uwagi

Ta metoda zwraca wartość 0, jeśli łączne użycie polecenia wynosi m_nTotalUsage0. W przeciwnym razie ta metoda zwraca wartość niezerową, jeśli procent użycia określonego polecenia jest większy niż wartość procentowa minimalna, m_nMinUsagePercentage. Domyślnie platforma ustawia minimalną wartość procentową na 5. Tę wartość można zastąpić przy użyciu metody CMFCCmdUsageCount::SetOptions . Jeśli minimalna wartość procentowa wynosi 0, ta metoda zwraca wartość niezerową, jeśli określona liczba poleceń jest większa niż 0.

CMFCToolBar::IsCommandRarelyUsed używa tej metody do określenia, czy polecenie jest rzadko używane.

CMFCCmdUsageCount::Reset

Czyści liczbę użycia wszystkich poleceń.

void Reset();

Uwagi

Wywołaj tę metodę, aby wyczyścić wszystkie wpisy ze struktury mapowania liczb poleceń, m_CmdUsage, i, aby zresetować całkowite użycie poleceń, m_nTotalUsage, licznik do 0.

CMFCCmdUsageCount::Serialize

Odczytuje ten obiekt z archiwum lub zapisuje go w archiwum.

virtual void Serialize(CArchive& ar);

Parametry

Ar
[in] CArchive Obiekt do serializacji z lub do.

Uwagi

Ta metoda serializuje strukturę mapy liczby poleceń, m_CmdUsagei łączne użycie poleceń, m_nTotalUsage, licznik z lub do określonego archiwum.

Aby zapoznać się z przykładami serializacji, zobacz Serializacja: serializacja obiektu.

CMFCCmdUsageCount::SetOptions

Ustawia wartości współużytkowanych CMFCCmdUsageCount składowych danych klasy.

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

Parametry

nStartCount
[in] Nowa początkowa liczba wszystkich śledzonych poleceń.

nMinUsagePercentage
[in] Nowy minimalny procent użycia.

Wartość zwracana

Wartość TRUE, jeśli metoda powiedzie się, false, jeśli parametr nMinUsagePercentage jest większy niż lub równy 100.

Uwagi

Ta metoda ustawia odpowiednio składowe m_nStartCount danych klasy udostępnionej CMFCCmdUsageCount oraz m_nMinUsagePercentage nStartCount i nMinUsagePercentage. m_nStartCount jest używany przez metodę CMFCCmdUsageCount::HasEnoughInformation w celu ustalenia, czy ten obiekt zebrał minimalną ilość danych śledzenia. m_nMinUsagePercentage jest używany przez metodę CMFCCmdUsageCount::IsFreqeuntlyUsedCmd , aby określić, czy dane polecenie jest często używane.

W obszarze Debugowanie kompilacje ta metoda generuje błąd asercji, jeśli parametr nMinUsagePercentage jest większy lub równy 100.

Zobacz też

Wykres hierarchii
Klasy
Klasa CMFCToolBar