CMFCCmdUsageCount 클래스
사용자가 메뉴에서 항목을 선택하는 경우와 같이 Windows 메시지의 사용 횟수를 추적합니다.
구문
class CMFCCmdUsageCount : public CObject
멤버
공용 생성자
| 속성 | 설명 |
|---|---|
CMFCCmdUsageCount::CMFCCmdUsageCount |
기본 생성자입니다. |
CMFCCmdUsageCount::~CMFCCmdUsageCount |
소멸자 |
공용 메서드
| 이름 | 설명 |
|---|---|
| CMFCCmdUsageCount::AddCmd | 지정된 명령과 연결된 카운터를 하나씩 증분합니다. |
| CMFCCmdUsageCount::GetCount | 지정된 명령 ID와 연결된 사용 횟수를 검색합니다. |
| CMFCCmdUsageCount::HasEnoughInformation | 이 개체가 추적 데이터의 최소 양을 수집했는지 여부를 확인합니다. |
| CMFCCmdUsageCount::IsFreqeuntlyUsedCmd | 지정된 명령이 자주 사용되는지 여부를 결정합니다. |
| CMFCCmdUsageCount::Reset | 모든 명령의 사용 횟수를 지웁니다. |
| CMFCCmdUsageCount::Serialize | 보관 파일에서 이 개체를 읽거나 보관 파일에 씁니다. ( CObject::Serialize를 재정의합니다.) |
| CMFCCmdUsageCount::SetOptions | 공유 CMFCCmdUsageCount 클래스 데이터 멤버의 값을 설정합니다. |
데이터 멤버
| 속성 | 설명 |
|---|---|
m_CmdUsage |
CMap 명령을 사용 횟수에 매핑하는 개체입니다. |
m_nMinUsagePercentage |
자주 사용할 명령에 대한 최소 사용 비율입니다. |
m_nStartCount |
이 개체가 추적 데이터의 최소 양을 수집했는지 여부를 확인하는 데 사용되는 시작 카운터입니다. |
m_nTotalUsage |
추적된 모든 명령의 수입니다. |
설명
클래스는 CMFCCmdUsageCount 각 숫자 Windows 메시지 식별자를 32비트 부호 없는 정수 카운터에 매핑합니다. CMFCToolBar 는 이 클래스를 사용하여 자주 사용되는 도구 모음 항목을 표시합니다. 자세한 CMFCToolBar내용은 CMFCToolBar 클래스를 참조 하세요.
프로그램 실행 간에 클래스 데이터를 유지할 CMFCCmdUsageCount 수 있습니다. CMFCCmdUsageCount::Serialize 메서드를 사용하여 클래스 멤버 데이터를 직렬화하고 CMFCCmdUsageCount::SetOptions 메서드를 사용하여 공유 멤버 데이터를 설정합니다.
상속 계층 구조
요구 사항
헤더: afxcmdusagecount.h
CMFCCmdUsageCount::AddCmd
지정된 명령과 연결된 카운터를 하나씩 증분합니다.
void AddCmd(UINT uiCmd);
매개 변수
uiCmd
[in] 증분할 명령 카운터를 지정합니다.
설명
이 메서드는 항목이 아직 없는 경우 명령 수의 맵 구조에 새 항목을 추가합니다 m_CmdUsage.
이 메서드는 다음 경우에 아무 작업도 수행하지 않습니다.
도구 모음 프레임워크는 사용자 지정 모드입니다( CMFCToolBar::IsCustomizeMode 메서드는 0이 아닌 값을 반환합니다).
이 명령은 하위 메뉴 또는 메뉴 구분 기호를 참조합니다( uiCmd 는 0 또는 -1과 같음).
uiCmd 는 표준 명령을 참조합니다(전역
IsStandardCommand함수는 0이 아닌 값을 반환합니다).
CMFCCmdUsageCount::GetCount
지정된 명령 ID와 연결된 사용 횟수를 검색합니다.
UINT GetCount(UINT uiCmd) const;
매개 변수
uiCmd
[in] 검색할 명령 카운터의 ID입니다.
Return Value
지정된 명령 ID와 연결된 사용 횟수입니다.
CMFCCmdUsageCount::HasEnoughInformation
이 개체가 추적 데이터의 최소 양을 받았는지 여부를 확인합니다.
BOOL HasEnoughInformation() const;
Return Value
이 개체가 추적 데이터의 최소 양을 받은 경우 0이 아닌 경우 그렇지 않으면 0입니다.
설명
이 메서드는 추적된 모든 명령의 총 개수가 초기 m_nStartCount개수m_nTotalUsage보다 크거나 같은 경우 0이 아닌 값을 반환합니다. 기본적으로 프레임워크는 초기 개수 0을 설정합니다. CMFCCmdUsageCount::SetOptions 메서드를 사용하여 이 값을 재정의할 수 있습니다 .
이 메서드는 CMFCMenuBar::IsShowAllCommands에서 사용 가능한 모든 메뉴 명령을 표시할지 여부를 결정하는 데 사용됩니다.
CMFCCmdUsageCount::IsFreqeuntlyUsedCmd
지정된 명령이 자주 사용되는지 여부를 결정합니다.
BOOL IsFreqeuntlyUsedCmd(UINT uiCmd) const;
매개 변수
uiCmd
[in] 확인할 명령을 지정합니다.
Return Value
명령이 자주 사용되는 경우 0이 아닌 경우 그렇지 않으면 0입니다.
설명
이 메서드는 총 명령 사용량이 m_nTotalUsage0이면 0을 반환합니다. 그렇지 않으면 지정된 명령이 사용되는 백분율이 최소 백분율보다 큰 경우 이 메서드는 0이 아닌 값을 m_nMinUsagePercentage반환합니다. 기본적으로 프레임워크는 최소 백분율을 5로 설정합니다. CMFCCmdUsageCount::SetOptions 메서드를 사용하여 이 값을 재정의할 수 있습니다 . 최소 백분율이 0이면 지정된 명령 수가 0보다 큰 경우 이 메서드는 0이 아닌 값을 반환합니다.
CMFCToolBar::IsCommandRarelyUsed 는 이 메서드를 사용하여 명령이 거의 사용되지 않는지 여부를 확인합니다.
CMFCCmdUsageCount::Reset
모든 명령의 사용 횟수를 지웁니다.
void Reset();
설명
이 메서드를 호출하여 명령 수 m_CmdUsage의 맵 구조에서 모든 항목을 지우고 총 명령 사용량을 m_nTotalUsage다시 설정하려면 0에 대응합니다.
CMFCCmdUsageCount::Serialize
보관 파일에서 이 개체를 읽거나 보관 파일에 씁니다.
virtual void Serialize(CArchive& ar);
매개 변수
ar
[in] CArchive 직렬화할 개체입니다.
설명
이 메서드는 명령 개수 m_CmdUsage의 맵 구조와 총 명령 사용량, m_nTotalUsage카운터를 지정된 보관 파일로 직렬화합니다.
serialization 예제는 Serialization: 개체 직렬화를 참조 하세요.
CMFCCmdUsageCount::SetOptions
공유 CMFCCmdUsageCount 클래스 데이터 멤버의 값을 설정합니다.
static BOOL __stdcall SetOptions(
UINT nStartCount,
UINT nMinUsagePercentage);
매개 변수
nStartCount
[in] 추적된 모든 명령의 새 초기 수입니다.
nMinUsagePercentage
[in] 새 최소 사용 비율입니다.
Return Value
메서드가 성공하면 TRUE이고 nMinUsagePercentage 매개 변수가 100보다 크거나 같으면 FALSE입니다.
설명
이 메서드는 공유 CMFCCmdUsageCount 클래스 데이터 멤버 m_nStartCount 와 m_nMinUsagePercentage nStartCount 및 nMinUsagePercentage를 각각 설정합니다. m_nStartCount는 CMFCCmdUsageCount::HasEnoughInformation 메서드에서 이 개체가 추적 데이터의 최소 양을 수집했는지 여부를 확인하는 데 사용됩니다. m_nMinUsagePercentage는 CMFCCmdUsageCount::IsFreqeuntlyUsedCmd 메서드에 의해 사용되어 지정된 명령이 자주 사용되는지 여부를 확인합니다.
디버그 빌드에서 nMinUsagePercentage 매개 변수가 100보다 크거나 같은 경우 이 메서드는 어설션 오류를 생성합니다.