CMFCCmdUsageCount Sınıfı

Kullanıcının menüden bir öğe seçmesi gibi Windows iletilerinin kullanım sayısını izler.

Sözdizimi

class CMFCCmdUsageCount : public CObject

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
CMFCCmdUsageCount::CMFCCmdUsageCount	Varsayılan oluşturucu.
CMFCCmdUsageCount::~CMFCCmdUsageCount	Yıkıcı.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CMFCCmdUsageCount::AddCmd	Verilen komutla ilişkili sayacı bir artırır.
CMFCCmdUsageCount::GetCount	Verilen komut kimliğiyle ilişkili kullanım sayısını alır.
CMFCCmdUsageCount::HasEnoughInformation	Bu nesnenin en düşük izleme verisi miktarını toplayıp toplamadığını belirler.
CMFCCmdUsageCount::IsFreqeuntlyUsedCmd	Verilen komutun sık kullanılıp kullanılmadığını belirler.
CMFCCmdUsageCount::Reset	Tüm komutların kullanım sayısını temizler.
CMFCCmdUsageCount::Serialize	Bu nesneyi bir arşivden okur veya bir arşive yazar. (Geçersiz Kılmalar CObject::Serialize.)
CMFCCmdUsageCount::SetOptions	Paylaşılan CMFCCmdUsageCount sınıf veri üyelerinin değerlerini ayarlar.

Veri Üyeleri

Veri Akışı Adı	Açıklama
m_CmdUsage	CMap Komutları kullanım sayılarıyla eşleyen bir nesne.
m_nMinUsagePercentage	Bir komutun sık kullanılacak en düşük kullanım yüzdesi.
m_nStartCount	Bu nesnenin en düşük izleme verisi miktarını toplayıp toplamadığını belirlemek için kullanılan başlangıç sayacı.
m_nTotalUsage	İzlenen tüm komutların sayısı.

Açıklamalar

sınıfı, CMFCCmdUsageCount her sayısal Windows ileti tanımlayıcısını 32 bit işaretsiz bir tamsayı sayacına eşler. CMFCToolBar sık kullanılan araç çubuğu öğelerini görüntülemek için bu sınıfı kullanır. hakkında CMFCToolBardaha fazla bilgi için bkz . CMFCToolBar Sınıfı.

Sınıf verilerini programınızın çalıştırmaları arasında kalıcı CMFCCmdUsageCount hale gelebilirsiniz. Sınıf üyesi verilerini serileştirmek için CMFCCmdUsageCount::Serialize yöntemini ve paylaşılan üye verilerini ayarlamak için CMFCCmdUsageCount::SetOptions yöntemini kullanın.

Devralma Hiyerarşisi

CObject

CMFCCmdUsageCount

Gereksinimler

Üst bilgi: afxcmdusagecount.h

CMFCCmdUsageCount::AddCmd

Verilen komutla ilişkili sayacı bir artırır.

void AddCmd(UINT uiCmd);

Parametreler

uiCmd
[in] Artıracak komut sayacını belirtir.

Açıklamalar

Bu yöntem, m_CmdUsagegirdi henüz yoksa, komut sayılarının eşleme yapısına yeni bir girdi ekler.

Bu yöntem aşağıdaki durumlarda hiçbir şey yapmaz:

• Araç çubuğu çerçevesi özelleştirme modundadır ( CMFCToolBar::IsCustomizeMode yöntemi sıfır olmayan bir değer döndürür).

• Komut bir alt menüye veya menü ayırıcısına başvurur ( uiCmd 0 veya -1'e eşittir).

• uiCmd standart bir komuta başvurur (genel IsStandardCommand işlev sıfır olmayan bir değer döndürür).

CMFCCmdUsageCount::GetCount

Verilen komut kimliğiyle ilişkili kullanım sayısını alır.

UINT GetCount(UINT uiCmd) const;

Parametreler

uiCmd
[in] Alınacak komut sayacının kimliği.

Dönüş Değeri

Verilen komut kimliğiyle ilişkili kullanım sayısı.

CMFCCmdUsageCount::HasEnoughInformation

Bu nesnenin en düşük izleme verisi miktarını alıp almadığını belirler.

BOOL HasEnoughInformation() const;

Dönüş Değeri

Bu nesne en düşük izleme verisi miktarını aldıysa sıfır olmayan; aksi takdirde 0.

Açıklamalar

İzlenen tüm komutların toplam sayısı ilk m_nStartCountsayıya eşit veya ondan büyükse, m_nTotalUsagebu yöntem sıfır olmayan bir değer döndürür. Çerçeve varsayılan olarak ilk sayıyı 0 olarak ayarlar. CMFCCmdUsageCount::SetOptions yöntemini kullanarak bu değeri geçersiz kılabilirsiniz.

Bu yöntem, kullanılabilir tüm menü komutlarının gösterilip gösterilmeyeceğini belirlemek için CMFCMenuBar::IsShowAllCommands tarafından kullanılır.

CMFCCmdUsageCount::IsFreqeuntlyUsedCmd

Verilen komutun sık kullanılıp kullanılmadığını belirler.

BOOL IsFreqeuntlyUsedCmd(UINT uiCmd) const;

Parametreler

uiCmd
[in] Denetlenecek komutu belirtir.

Dönüş Değeri

Komut sık kullanılıyorsa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Toplam komut kullanımı 0 ise, m_nTotalUsagebu yöntem 0 döndürür. Aksi takdirde, belirtilen komutun kullanıldığı yüzde minimum yüzde m_nMinUsagePercentagedeğerinden büyükse, bu yöntem sıfır olmayan değerini döndürür. Çerçeve varsayılan olarak en düşük yüzdeyi 5 olarak ayarlar. CMFCCmdUsageCount::SetOptions yöntemini kullanarak bu değeri geçersiz kılabilirsiniz. En düşük yüzde 0 ise, belirtilen komut sayısı 0'dan büyükse bu yöntem sıfır olmayan değerini döndürür.

CMFCToolBar::IsCommandRarelyUsed , bir komutun nadiren kullanılıp kullanılmadığını belirlemek için bu yöntemi kullanır.

CMFCCmdUsageCount::Reset

Tüm komutların kullanım sayısını temizler.

void Reset();

Açıklamalar

Komut sayılarının m_CmdUsageeşleme yapısındaki tüm girdileri temizlemek ve toplam komut kullanımı m_nTotalUsageolan , sayacını 0 olarak sıfırlamak için bu yöntemi çağırın.

CMFCCmdUsageCount::Serialize

Bu nesneyi bir arşivden okur veya bir arşive yazar.

virtual void Serialize(CArchive& ar);

Parametreler

Ar
[in] CArchive veya öğesinden serileştirilip serileştirilip serileştirilene bir nesne.

Açıklamalar

Bu yöntem, komut sayılarının eşleme yapısını, m_CmdUsageve toplam komut kullanımını, m_nTotalUsage, sayacını veya belirtilen arşive serileştirir.

Serileştirme örnekleri için bkz . Serileştirme: Bir Nesneyi Seri Hale Getirme.

CMFCCmdUsageCount::SetOptions

Paylaşılan CMFCCmdUsageCount sınıf veri üyelerinin değerlerini ayarlar.

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

Parametreler

nStartCount
[in] İzlenen tüm komutların yeni ilk sayısı.

nMinUsagePercentage
[in] Yeni en düşük kullanım yüzdesi.

Dönüş Değeri

Yöntem başarılı olursa TRUE, nMinUsagePercentage parametresi 100'den büyük veya buna eşitse YANLIŞ.

Açıklamalar

Bu yöntem, paylaşılan CMFCCmdUsageCount sınıf veri üyelerini m_nStartCount ve m_nMinUsagePercentage sırasıyla nStartCount ve nMinUsagePercentage olarak ayarlar. m_nStartCount, CMFCCmdUsageCount::HasEnoughInformation yöntemi tarafından bu nesnenin en düşük izleme verisi miktarını toplayıp toplamadığını belirlemek için kullanılır. m_nMinUsagePercentageCMFCCmdUsageCount::IsFreqeuntlyUsedCmd yöntemi tarafından belirli bir komutun sık kullanılıp kullanılmadığını belirlemek için kullanılır.

Hata ayıklama derlemelerinde, nMinUsagePercentage parametresi 100'den büyük veya buna eşitse bu yöntem onay hatası oluşturur.

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar
CMFCToolBar Sınıfı