Kelas CMFCCmdUsageCount

Melacak jumlah penggunaan pesan Windows, seperti ketika pengguna memilih item dari menu.

Sintaks

class CMFCCmdUsageCount : public CObject

Anggota

Konstruktor Publik

Nama	Deskripsi
CMFCCmdUsageCount::CMFCCmdUsageCount	Konstruktor default.
CMFCCmdUsageCount::~CMFCCmdUsageCount	Destruktor.

Metode Publik

Nama	Deskripsi
CMFCCmdUsageCount::AddCmd	Kenaikan satu penghitung yang terkait dengan perintah yang diberikan.
CMFCCmdUsageCount::GetCount	Mengambil jumlah penggunaan yang terkait dengan ID perintah yang diberikan.
CMFCCmdUsageCount::HasEnoughInformation	Menentukan apakah objek ini telah mengumpulkan jumlah minimum data pelacakan.
CMFCCmdUsageCount::IsFreqeuntlyUsedCmd	Menentukan apakah perintah yang diberikan sering digunakan.
CMFCCmdUsageCount::Reset	Menghapus jumlah penggunaan semua perintah.
CMFCCmdUsageCount::Serialize	Membaca objek ini dari arsip atau menulisnya ke arsip. (Penimpaan CObject::Serialize.)
CMFCCmdUsageCount::SetOptions	Mengatur nilai anggota data kelas bersama CMFCCmdUsageCount .

Anggota Data

Nama	Deskripsi
m_CmdUsage	Objek CMap yang memetakan perintah ke jumlah penggunaannya.
m_nMinUsagePercentage	Persentase penggunaan minimum untuk perintah yang sering digunakan.
m_nStartCount	Penghitung mulai yang digunakan untuk menentukan apakah objek ini telah mengumpulkan jumlah minimum data pelacakan.
m_nTotalUsage	Jumlah semua perintah terlacak.

Keterangan

Kelas CMFCCmdUsageCount memetakan setiap pengidentifikasi pesan Windows numerik ke penghitung bilangan bulat yang tidak ditandatangani 32-bit. CMFCToolBar menggunakan kelas ini untuk menampilkan item bilah alat yang sering digunakan. Untuk informasi selengkapnya tentang CMFCToolBar, lihat Kelas CMFCToolBar.

Anda dapat mempertahankan CMFCCmdUsageCount data kelas di antara eksekusi program Anda. Gunakan metode CMFCCmdUsageCount::Serialize untuk membuat serialisasi data anggota kelas dan metode CMFCCmdUsageCount::SetOptions untuk mengatur data anggota bersama.

Hierarki Warisan

CObject

CMFCCmdUsageCount

Persyaratan

Header: afxcmdusagecount.h

CMFCCmdUsageCount::AddCmd

Kenaikan satu penghitung yang terkait dengan perintah yang diberikan.

void AddCmd(UINT uiCmd);

Parameter

uiCmd
[di] Menentukan penghitung perintah untuk kenaikan.

Keterangan

Metode ini menambahkan entri baru ke struktur peta jumlah perintah, , m_CmdUsagejika entri belum ada.

Metode ini tidak melakukan apa pun dalam kasus berikut:

• Kerangka kerja toolbar dalam mode kustomisasi ( metode CMFCToolBar::IsCustomizeMode mengembalikan nilai bukan nol).

• Perintah mengacu pada submenu atau pemisah menu ( uiCmd sama dengan 0 atau -1).

• uiCmd mengacu pada perintah standar (fungsi global IsStandardCommand mengembalikan nilai bukan nol).

CMFCCmdUsageCount::GetCount

Mengambil jumlah penggunaan yang terkait dengan ID perintah yang diberikan.

UINT GetCount(UINT uiCmd) const;

Parameter

uiCmd
[di] ID penghitung perintah yang akan diambil.

Tampilkan Nilai

Jumlah penggunaan yang terkait dengan ID perintah yang diberikan.

CMFCCmdUsageCount::HasEnoughInformation

Menentukan apakah objek ini telah menerima jumlah minimum data pelacakan.

BOOL HasEnoughInformation() const;

Tampilkan Nilai

Bukan nol jika objek ini telah menerima jumlah minimum data pelacakan; jika tidak, 0.

Keterangan

Metode ini mengembalikan nilai bukan nol jika jumlah total, m_nTotalUsage, dari semua perintah yang dilacak sama dengan atau lebih besar dari jumlah awal, m_nStartCount. Secara default, kerangka kerja menetapkan jumlah awal 0. Anda dapat mengambil alih nilai ini dengan menggunakan metode CMFCCmdUsageCount::SetOptions .

Metode ini digunakan oleh CMFCMenuBar::IsShowAllCommands untuk menentukan apakah akan menampilkan semua perintah menu yang tersedia.

CMFCCmdUsageCount::IsFreqeuntlyUsedCmd

Menentukan apakah perintah yang diberikan sering digunakan.

BOOL IsFreqeuntlyUsedCmd(UINT uiCmd) const;

Parameter

uiCmd
[di] Menentukan perintah yang akan diperiksa.

Tampilkan Nilai

Bukan nol jika perintah sering digunakan; jika tidak, 0.

Keterangan

Metode ini mengembalikan 0 jika total penggunaan perintah, m_nTotalUsage, adalah 0. Jika tidak, metode ini mengembalikan nonzero jika persentase yang digunakan perintah yang ditentukan lebih besar dari persentase minimum, m_nMinUsagePercentage. Secara default, kerangka kerja menetapkan persentase minimum menjadi 5. Anda dapat mengambil alih nilai ini dengan menggunakan metode CMFCCmdUsageCount::SetOptions . Jika persentase minimum adalah 0, metode ini mengembalikan nonzero jika jumlah perintah yang ditentukan lebih besar dari 0.

CMFCToolBar::IsCommandRarelyUsed menggunakan metode ini untuk menentukan apakah perintah jarang digunakan.

CMFCCmdUsageCount::Reset

Menghapus jumlah penggunaan semua perintah.

void Reset();

Keterangan

Panggil metode ini untuk menghapus semua entri dari struktur peta jumlah perintah, , m_CmdUsagedan untuk mengatur ulang total penggunaan perintah, m_nTotalUsage, penghitung ke 0.

CMFCCmdUsageCount::Serialize

Membaca objek ini dari arsip, atau menulisnya ke arsip.

virtual void Serialize(CArchive& ar);

Parameter

Ar
[di] Objek CArchive untuk diserialisasikan dari atau ke.

Keterangan

Metode ini menserialisasikan struktur peta jumlah perintah, m_CmdUsage, dan total penggunaan perintah, m_nTotalUsage, penghitung dari atau ke arsip yang ditentukan.

Untuk contoh serialisasi, lihat Serialisasi: Membuat Serialisasi Objek.

CMFCCmdUsageCount::SetOptions

Mengatur nilai anggota data kelas bersama CMFCCmdUsageCount .

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

Parameter

nStartCount
[di] Jumlah awal baru dari semua perintah terlacak.

nMinUsagePercentage
[di] Persentase penggunaan minimum baru.

Tampilkan Nilai

TRUE jika metode berhasil, FALSE jika parameter nMinUsagePercentage lebih besar dari atau sama dengan 100.

Keterangan

Metode ini mengatur anggota m_nStartCount data kelas bersama CMFCCmdUsageCount dan m_nMinUsagePercentage ke nStartCount dan nMinUsagePercentage, masing-masing. m_nStartCount digunakan oleh metode CMFCCmdUsageCount::HasEnoughInformation untuk menentukan apakah objek ini telah mengumpulkan jumlah minimum data pelacakan. m_nMinUsagePercentage digunakan oleh metode CMFCCmdUsageCount::IsFreqeuntlyUsedCmd untuk menentukan apakah perintah tertentu sering digunakan.

Dalam Debug membangun metode ini menghasilkan kegagalan pernyataan jika parameter nMinUsagePercentage lebih besar dari atau sama dengan 100.

Lihat juga

Bagan Hierarki
Kelas
Kelas CMFCToolBar