void CDialog::OnContextMenu(CWnd* pWnd, CPoint point)
{
// TODO: Add your message handler code here
CMenu *pMenu, *pSubmenu;
pMenu = new CMenu();
pMenu->LoadMenu(IDR_MNU_MAIN_POPUP);
pSubmenu = pMenu->GetSubMenu(0);
pSubmenu->TrackPopupMenu(
TPM_LEFTALIGN | TPM_RIGHTBUTTON,
point.x, point.y, this);
}
========================================
메뉴의 체크표시
1. 메뉴에 체크표시 여부 알아내기
// MainFrame을 찾는다.
CMainFrame *pFrame = (CMainFrame*) AfxGetMainWnd();
// 메뉴의 상태를 알아보자.
UINT state = pFrame->GetMenu()->GetMenuState(ID_FILE_NEW, MF_BYCOMMAND);
UINT state = pFrame->GetMenu()->GetMenuState(ID_FILE_NEW, MF_BYCOMMAND);
// 메뉴의 체크 여부 확인
if(state & MF_CHECKED)
{
// 메뉴에 체크 표시 됨.
}
else
{
// 메뉴에 체크 표시 안됨.
}
2. 메뉴에 체크 표시하기
CheckMenuItem(::GetMenu(pFrame->m_hWnd), ID_FILE_NEW, MF_CHECKED);
3. 메뉴에 체크 표시 지우기
CheckMenuItem(::GetMenu(pFrame->m_hWnd), ID_FILE_NEW, MF_UNCHECKED);
=========================================
HINSTANCE hOld = AfxGetResourceHandle();
AfxSetResourceHandle(g_hInstance);
AfxSetResourceHandle(g_hInstance);
LPCSTR szDllName; // DLL명만 넣는다.
//메뉴 생성
CMenu menu;
menu.CreatePopupMenu();
menu.CreatePopupMenu();
//
char szTemp[64];
long lPosAll = 0;
long lSize = 0;
long lPosAll = 0;
long lSize = 0;
//KHD : Popup Menu 추가 , 임의 ID 부여
menu.AppendMenu(MF_STRING,(UINT)10001,"지표최적화");
menu.AppendMenu(MF_STRING,(UINT)10002,"시간최적화");
menu.AppendMenu(MF_STRING,(UINT)10003,"변수최적화");
//
UINT nFlagsForMenu = TPM_LEFTALIGN | TPM_RIGHTBUTTON | TPM_NONOTIFY | TPM_RETURNCMD;
CRect rect;
GetDlgItem(IDC_STOPTIMA)->GetWindowRect(rect);
int nRetValue = menu.TrackPopupMenu(nFlagsForMenu, rect.left, rect.bottom, this);
if(!nRetValue) return;
menu.DestroyMenu();
CRect rect;
GetDlgItem(IDC_STOPTIMA)->GetWindowRect(rect);
int nRetValue = menu.TrackPopupMenu(nFlagsForMenu, rect.left, rect.bottom, this);
if(!nRetValue) return;
menu.DestroyMenu();
////
// 로드된 메뉴 Index에 따라 실행한다. 함수도 괜찮고... ^^;;
switch(nRetValue) {
case 10001:
szDllName = "IndexOptimizer";
break;
case 10002:
szDllName = "TimeOptimizer";
break;
case 10003:
szDllName = "VariableOptimizer";
break;
}
case 10001:
szDllName = "IndexOptimizer";
break;
case 10002:
szDllName = "TimeOptimizer";
break;
case 10003:
szDllName = "VariableOptimizer";
break;
}
/////////////////////////////
CTabSystemTradingEx* pParentDlg = (CTabSystemTradingEx*)GetParent();
CDllDlg dlg(szDllName,szDllName, NULL, hOld);
dlg.DoModal();
if(dlg.m_hTradeInst) FreeLibrary(dlg.m_hTradeInst);
CTabSystemTradingEx* pParentDlg = (CTabSystemTradingEx*)GetParent();
CDllDlg dlg(szDllName,szDllName, NULL, hOld);
dlg.DoModal();
if(dlg.m_hTradeInst) FreeLibrary(dlg.m_hTradeInst);
/////////////////////////////////////////////////////////////////////////
================================================================================
팝업 메뉴란 마우스 오른쪽 버튼을 눌렀을 때 나타나는 메뉴를 말한다.
상황과 위치에 따라 메뉴의 내용이 바뀌는 이런 메뉴를 컨텍스트 메뉴(Context menu)라고 하며 또한 화면의 임의위치에 불쑥 나타나기 때문에 팝업 메뉴라고도 한다.
팝업 메뉴튼 마우스 오른쪽 버튼을 누를 때 나타나므로 WM_RBUTTONDOWN메시지 핸들러에서 팝업 메뉴를 나타내면 된다.
또는 팝업 메뉴 전용의 WM_CONTEXTMENU 메시지를 사용해도 된다.
메뉴 리소스를 읽어오고 읽어온 메뉴에서 팝업으로 사용할 메뉴 리스트를 선택한다.
BOOL LoadMenu( UINT nlDResource );
CMenu* GetSubMenu( int nPos ) const;
위 두 함수는 CMenu의 멤버함수이다.
메뉴 리스트를 읽은 후 다음 함수로 메뉴를 화면에 출력
BOOL TrackPopupMenu( UINT nFlags, int x, int y, CWnd* pWnd, LPCRECT lpRect = 0 );
만드는 법
1. 리소스 스크립트를 이용해서 팝업 메뉴를 만든다. 굳이 설명을 하지 않아도 알 것이라 생각한다.
2. 팝업 메뉴를 뷰에 붙일 것이므로 뷰에 WM_CONTEXTMENU에시지 핸들러 만들어 다음과 같이 코드를 작성
void CPopupView::OnContextMenu(CWnd* pWnd, CPoint point )
{
CMenu popup;
CMenu *MyMenu;
popup.LoadMenu(IDR_MENU1);
MyMenu=popup.GetSubMenu(0); //'1'로 하면 두번째 메뉴가 나타난다.
MyMenu->TrackPopupMenu( TPM_LEFTALIGN | TPM_RIGHTBUTTON, point.x, point.y, this );
}
3. 메뉴항목에 대한 핸들러를 작성한다. TrackPopupMenu의 네 번째 인수가 this, 즉 뷰로 지정되어 있으므로 팝업 메뉴로 부터 발생하는 메시지는 뷰가 받게 된다. 그래서 뷰에 팝업 메뉴항목의 핸들러를 만들고 다음과 같이 코드를 작성한다. 편집상 문자열 두 줄로 표시했지만 실제 코드로는 한 줄에 써넣어야 한다.
void CPopupView::OnPopupTitle1()
{
AfxGetMainWnd()->SetWindowText(" 첫 번재 팝업 메뉴항목을 선택했습니다");
}
만약 WM_CONTEXTMENU를 사용하지 않고 WM_RBUTTONDOWN을 사용한다면 한줄을 더 추가해줘야 한다.
즉 TrackPopupMenu함수가 사용하는 좌표는 전체화면의 좌측상단을 기준으로 하고 있기 때문에 두 좌표의 실제의미는 다르다.
그래서 ClientScreen 함수를 사용하여 point의 값을 전체화면을 기준 좌표로 변경해 주는 코드가 추가
즉 CLientToScreen(&point);
===================================================================================
CMenu 클래스는 윈도우 HMENU가 캡슐화된 것이다. 이것은 메뉴의 생성, 추적, 갱신, 소멸에 관한 멤버 함수를 제공한다.
로컬로서 정적 프레임에 CMenu 객체를 생성하고, 필요한 새로운 메뉴를 조작하는 멤버 함수를 호출하라. 다음으로, 윈도우에메뉴를 설정하기위해 CWnd::SetMenu를 호출하고, 곧바로 CMenu 객체의 Detach 멤버 함수를 호출이 뒤따른다.CWnd::SetMenu 멤버 함수는 윈도우의 메뉴에 새로운 메뉴를 설정하고, 메뉴의 변화를 반영하여 다시 그려지도록 윈도우에메뉴의 소유권을 넘긴다. Detach의 호출은 CMenu객체로부터 HMENU를 분리하고, 그럼으로써 CMenu 변수가 범위를 벗어날때 CMenu객체의 소멸자가 더이상 소유하지 않는 메뉴를 소멸하려고 하지 않도록 한다. 메뉴 그 차제는 자동으로 윈도우가 소멸될 때 같이 소멸된다.
메모리의 템플릿에서 메뉴를 생성하기 위해 LoadMenuIndirect 멤버 함수를 사용할 수 있으나, LoadMenu를 호출함으로써 리소스로부터 메뉴를 생성된 메뉴는 쉽게 조작할 수 있고, 메뉴 리소스 자체가 메뉴 에디터를 통하여 생성되고 수정될 수 있다.
#include <afxwin.h>
CMenu Class Members
데이버 멤버
m_hMenu
|
CMenu 객체에 부가된 윈도우 메뉴에 대한 핸들을 지정한다.
|
생성자
Cmenu
|
CMenu 객체를 생성한다.
|
Initialization
Attach
|
CMenu 객체에 윈도우 메뉴 핸들을 붙인다.
|
Detach
|
CMenu 객체로부터 윈도우 메뉴 핸들을 분리하고, 핸들을 반환한다.
|
FromHandle
|
윈도우 메뉴 핸들을 부여한 CMenu 객체에 대한 포인터를 반환한다.
|
GetSafeHmenu
|
CMenu 객체에 의해 보호된 m_hMenu를 반환한다.
|
DeleteTempMap
|
FromHandle 멤버 함수에 의해 생성된 임시 CMenu 객체를 삭제한다.
|
CreateMenu
|
빈 메뉴를 생성하고 이것을 CMenu객체에 부가한다.
|
CreatePopupMenu
|
빈 팝업 메뉴를 생성하고 이것을 CMenu 객체에 부가한다.
|
LoadMenu
|
실행 가능한 파일로부터 메뉴 리소스를 로드하고 이것을 CMenu 객체에 부가한다.
|
LoadMenuIndirect
|
메모리의 메뉴 템플릿으로부터 메뉴를 로드하고 이것을 CMenu 객체에 부가한다.
|
DestroyMenu
|
CMenu객체에 부가된 메뉴를 소멸시키고 메뉴가 차지하고 있던 메모리를 해제한다.
|
Menu Operations
DeleteMenu
|
메뉴에서 특정 아이템을 삭제한다. 만약 메뉴 아이템에 연결된 팝업 메뉴가존재한다면, 팝업 메뉴의 핸들을 소멸하고, 이것에 의해 사용된 메모리를 해제한다.
|
TrackPopupMenu
|
특정 위치에서 떠있는 팝업 메뉴를 보여주고, 팝업 메뉴에서 아이템의 선택을 추적한다.
|
Menu Item Operations
AppendMenu
|
현재 메뉴의 끝에 새로운 아이템을 추가한다.
|
CheckMenuItem
|
팝업 메뉴의 아이템 옆에 체크 마크를 표시하던가 또는 체크 마크를 삭제한다.
|
CheckMenuRadioItem
|
팝업 메뉴의 아이템 옆에 라디오 버튼을 표시하고 그룹내에 있는 다른메뉴에서는 라디오 버튼을 삭제한다.
|
EnableMenuItem
|
메뉴 아이템을 활성화, 비활성화, 또는 희미하게(회색) 만든다.
|
GetMenuItemCount
|
팝업 메뉴 또는 최상위 레벨 메뉴에 있는 아이템의 개수를 얻는다.
|
GetMenuItemID
|
지정된 위치에 존재하는 메뉴 아이템의 식별자를 얻는다.
|
GetMenuState
|
지정된 메뉴 아이템의 상태 또는 팝업 메뉴내의 아이템의 개수를 반환한다.
|
GetMenuString
|
지정된 메뉴 아이템의 레이블(문자열)을 가져온다.
|
GetSubMenu
|
팝업 메뉴의 포인터를 얻는다.
|
InsertMenu
|
지정된 위치에 새로운 메뉴 아이템을 삽입하고, 밑에 있는 아이템을 아래로 이동시킨다.
|
ModifyMenu
|
지정된 위치에 존재하는 메뉴 아이템을 변경한다.
|
RemoveMenu
|
지정된 메뉴에서 팝업 메뉴와 연관된 메뉴 아이템을 삭제한다.
|
SetMenuItemBitmaps
|
메뉴 아이템에 특정 체크 마크 비트맵을 연결시킨다.
|
GetMenuContextHelpId
|
메뉴와 연관된 help context ID를 가져온다.
|
SetMenuContextHelpId
|
메뉴와 연관되도록 help context ID를 설정한다.
|
오버라이드 가능한 함수
DrawItem
|
Called by the framework when a visual aspect of an owner-drawn menu hanges.
|
MeasureItem
|
Called by the framework to determine menu dimensions when an owner-drawn menu is created.
|
CMenu::m_hMenu
Remarks
CMenu 객체에 부가된 윈도우 메뉴의 HMENU 핸들을 지정한다.
CMenu::CMenu
CMenu( );
Remarks
메뉴는 여러분이 CMenu의 생성 또는 로드 관련 함수를 호출하기 전까지는 생성되지 않는다:
l CreateMenu
l CreatePopupMenu
l LoadMenu
l LoadMenuIndirect
CMenu::Attach
BOOL Attach( HMENU hMenu );
반환값
제대로 동작했으면 0이 아닌 값; 그렇지 않으면 0.
파라미터
hMenu 윈도우 메뉴에 대한 핸들을 지정한다.
Remarks
CMenu 객체에 존재하는 윈도우 메뉴를 붙인다. 이 함수는 이미 어떠한 메뉴가 CMenu 객체에 붙어있으면 호출되어서는안된다. 메뉴 핸들은 m_hMenu 데이터 멤버에 저장된다.
만약 여러분이 다루고자 하는 메뉴가 이미 윈도우와 연결되어있다면, 메뉴의 핸들을 얻기위해 CWnd::GetMenu 함수를사용할 수 있다.
CMenu::Detach
HMENU Detach( );
반환값
성공하면 HMENU 타입의 윈도우 메뉴 핸들; 그렇지 않으면 NULL.
Remarks
CMenu 객체로부터 윈도우 핸들을 분리하고 핸들을 반환한다. m_hMenu 데이터 멤버는 NULL로 설정된다.
CMenu::FromHandle
static CMenu* PASCAL FromHandle( HMENU hMenu );
반환값
임시적 또는 영구적인 CMenu 의 포인터.
파라미터
hMenu 메뉴에 대한 윈도우 핸들.
Remarks
주어진 메뉴에 대한 윈도우 핸들의 CMenu 객체의 포인터를 반환한다. 만약 CMenu 객체가 아직 윈도우 메뉴 객체에 부여되지 않았다면, 임시 CMenu 객체가 생성되고 이것에 부가된다.
이 임시 CMenu 객체는 다음번 응용프로그램이 이벤트 루프에서 유휴 시간을 가질 때까지만 유효하고 그 시점에서 모든임시 객체는 삭제된다.
CMenu::GetSafeHmenu
HMENU GetSafeHmenu( ) const;
Remarks
CMenu 객체에 의해 보호되는 HMENU, 또는 NULL CMenu 포인터를 반환한다.
CMenu::DeleteTempMap
static void PASCAL DeleteTempMap( );
Remarks
CWinApp 유휴 시간 핸들러에 의해 자동적으로 호출되고, DeleteTempMap은 FromHandle 멤버 함수에 의해 생성된 모든 임시 CMenu 객체를 삭제한다. DeleteTempMap은 CMenu 객체를 삭제하기 전에 임시 CMenu 객체에 부가된 윈도우 메뉴 객체를 분리시킨다.
CMenu::CreateMenu
BOOL CreateMenu( );
반환값
메뉴가 성공적으로 생성되면 0이 아닌 값; 그렇지 않으면 0.
Remarks
메뉴를 생성하고 이것을 CMenu 객체에 부가한다.
메뉴는 초기에는 비어있다. 메뉴 아이템은 AppendMenu 또는 InsertMenu 멤버 함수에 의해 추가될 수 있다.
만약 메뉴가 윈도우에 할당되면, 메뉴는 윈도우가 소멸될 때 자동으로 소멸된다.
만약 메뉴가 윈도우에 부가되지 않았다면, 응용프로그램은 종료하기 전에 반드시 메뉴와 연관된 시스템 리소스를 해제해야만 한다. 응용프로그램은 DestroyMenu 멤버 함수를 호출함으로써 메뉴를 해제한다.
CMenu::CreatePopupMenu
BOOL CreatePopupMenu( );
반환값
팝업 메뉴가 성공적으로 생성되면 0이 아닌 값; 그렇지 않으면 0.
Remarks
팝업 메뉴를 생성하고 이것을 CMenu 객체에 부여한다.
메뉴는 초기에는 비어있다. 메뉴 아이템은 AppendMenu 또는 InsertMenu 멤버 함수에 의해 추가될 수 있다. 응용프로그램은 기존의 메뉴나 팝업 메뉴에 팝업 메뉴를 추가할 수 있다. TrackPopupMenu 멤버 함수는 플로팅 팝업 메뉴로써 메뉴를 보여주고, 팝업 메뉴에서 선택을 추적하기위해 사용될 수 있다.
만약 메뉴가 윈도우에 할당되면, 메뉴는 윈도우가 소멸될 때 자동으로 소멸된다. 만약 메뉴가 기존의 메뉴에 추가되었다면, 기존 메뉴가 소멸될 때 자동으로 소멸된다.
만약 메뉴가 윈도우에 부가되지 않았다면, 응용프로그램은 종료하기 전에 반드시 메뉴와 연관된 시스템 리소스를 해제해야만 한다. 응용프로그램은 DestroyMenu 멤버 함수를 호출함으로써 메뉴를 해제한다.
CMenu::LoadMenu
BOOL LoadMenu( LPCTSTR lpszResourceName );
BOOL LoadMenu( UINT nIDResource );
반환값
메뉴 리소스가 성공적으로 로드되면 0이 아닌 값; 그렇지 않으면 0.
파라미터
lpszResourceName 로드될 메뉴 리소스의 이름을 담고있는 널문자로 종료된 문자열의 포인터.
nIDResource 로드될 메뉴 리소스의 메뉴 ID를 지정.
Remarks
응용프로그램의 실행 가능한 파일로부터 메뉴 리소스를 로드하여 이것을 CMenu 객체에 부여한다.
만약 메뉴가 윈도우에 부가되지 않았다면, 응용프로그램은 종료하기 전에 반드시 메뉴와 연관된 시스템 리소스를 해제해야만 한다. 응용프로그램은 DestroyMenu 멤버 함수를 호출함으로써 메뉴를 해제한다.
CMenu::LoadMenuIndirect
BOOL LoadMenuIndirect( const void* lpMenuTemplate );
반환값
메뉴 리소스가 성공적으로 로드되면 0이 아닌 값; 그렇지 않으면 0.
파라미터
lpMenuTemplate 메뉴 템플릿(단일 MENUITEMTEMPLATEHEADER 구조체와 하나 이상의 MENUITEMTEMPLATE 구조체의 콜렉션)의 포인터. 이 두개의 구조체에 대한 자세한 정보는 Win32 DSK Documentation을 참조하라.
Remarks
메모리의 메뉴 템플릿으로부터 리소스를 로드하여 이것을 CMenu 객체에 부여한다. 메뉴 템플릿은 하나 이상의MENUITEMTEMPLATE 구조체(이것은 하나 이상의 메뉴 아이템과 팝업 메뉴를 포함한다)의 콜렉션에 따른 헤더이다.
버전 번호는 반드시 0이어야 한다.
mtOption 플래그는 주 리스트와 팝업 리스트의 마지막 아이템으로써 MF_END 플래그를 포함해야만 한다. 다른 플래그는AppendMenu 멤버 함수를 참조하라. mtId 멤버는 MF_POPUP이 mtOption에 지정될 때 반드시 MENUITEMTEMPLATE 구조체에서 생략되어야 한다.
MENUITEMTEMPLATE 구조체를 위해 할당된 공간은 mtString이 메뉴 아이템의 이름을 간직할 수 있을 정도로 충분히 커야만 한다.
만약 메뉴가 윈도우에 부가되지 않았다면, 응용프로그램은 종료하기 전에 반드시 메뉴와 연관된 시스템 리소스를 해제해야만 한다. 응용프로그램은 DestroyMenu 멤버 함수를 호출함으로써 메뉴를 해제한다.
CMenu::DestroyMenu
BOOL DestroyMenu( );
반환값
메뉴가 소멸되면 0이 아닌 값; 그렇지 않으면 0.
Remarks
메뉴와 사용된 윈도우 리소스를 소멸시킨다. 메뉴는 소멸되기 전에 CMenu 객체로부터 분리된다. 윈도우의 DestroyMenu 함수는 CMenu 소멸자에서 자동으로 호출된다.
CMenu::DeleteMenu
BOOL DeleteMenu( UINT nPosition, UINT nFlags );
반환값
함수가 성공적으로 수행되면 0이 아닌 값; 그렇지 않으면 0.
파라미터
nPosition nFlags에 의해 결정되는, 지워질 메뉴 아이템을 지정한다.
nFlags 다음의 방식으로 nPosition을 해석할 때 사용된다:
nFlags
|
nPosition의 해석
|
MF_BYCOMMAND
|
기존 메뉴 아이템의 명령 ID를 부여하는 파라미터를 지정한다. MF_BYCOMMAND 또는 MF_BYPOSITION이 설정되어있지 않다면 이것이 디폴트이다.
|
MF_BYPOSITION
|
기존 메뉴 아이템의 위치를 부여하는 파라미터를 지정한다. 첫번째 아이템은 0에 위치한다.
|
Remarks
메뉴에서 아이템을 삭제한다. 만약 메뉴 아이템이 팝업 메뉴와 연관되어있다면, DeleteMenu는 팝업 메뉴의 핸들을 소멸하고, 팝업 메뉴에 의해 사용되던 메모리를 해제한다.
윈도우에 상주하는 메뉴가 변경될 때(윈도우가 보여지거나 그렇지 않을 때), 응용프로그램은 반드시CWnd::DrawMenuBar를 호출해야한다.
CMenu::TrackPopupMenu
BOOL TrackPopupMenu( UINT nFlags, int x, int y, CWnd* pWnd, LPCRECT lpRect = NULL );
반환값
함수가 성공적으로 수행되면 0이 아닌 값; 그렇지 않으면 0.
파라미터
nFlags 마우스 버튼 플래그와 스크린 위치 플래그를 지정한다. 스크린 위치 플래그는 다음중의 하나가 될 수 있다:
l TPM_CENTERALIGN x 좌표에 의해 지정된 위치에서 수평상으로 중앙에 팝업 메뉴를 위치시킨다.
l TPM_LEFTALIGN x 좌표에 의해 지정된 위치에서 왼편에 팝업 메뉴를 위치시킨다.
l TPM_RIGHTALIGN x 좌표에 의해 지정된 위치에서 오른편에 팝업 메뉴를 위치시킨다.
마우스 버튼 플래그는 다음 중의 하나이다:
l TPM_LEFTBUTTON 팝업 메뉴가 마우스 왼쪽 버튼을 따르도록 한다.
l TPM_RIGHTBUTTON 팝업 메뉴가 마우스 오른쪽 버튼을 따르도록 한다.
x 화면 좌표계에서 팝업 메뉴의 수평 위치를 지정한다. nFlags 파라미터 값에 따라, 메뉴는 이 위치에 상대적으로 왼쪽정렬, 오른쪽 정렬 또는 가운데 정렬이 될 수 있다.
y 화면 좌표계에서 팝업 메뉴 최상위의 수직 위치를 지정한다.
pWnd 팝업 메뉴를 소유하는 윈도우를 지정한다. 이 윈도우가 메뉴로부터 WM_COMMAND 메시지를 받는다. 윈도우 3.1이상 버전에서, 윈도우는 TrackPopupMenu가 리턴하기전까지는 WM_COMMAND 메시지를 받을 수 없다. 윈도우 3.0에서는 TrackPopupMenu가 리턴하기전에 윈도우가 WM_COMMAND 메시지를 받는다.
lpRect 사용자가 팝업 메뉴를 띄어놓은 채로 클릭할 수 있는 화면상 직사각 영역의 좌표를 담고 있는 RECT 구조체 또는 CRect 객체를 가리킨다. 만약 이 파라미터가 NULL이면, 사용자가 팝업 메뉴 바깥을 클릭할 때 팝업 메뉴는 사라진다.윈도우 3.0에서는 반드시 NULL이었다.
윈도우 3.1 버전 이상에서는 다음 상수값을 사용할 수 있다:
l TPM_CENTERALIGN
l TPM_LEFTALIGN
l TPM_RIGHTALIGN
l TPM_RIGHTBUTTON
Remarks
지정된 위치에 플로팅 팝업 메뉴를 보여주고, 팝업 메뉴상의 아이팀의 선택을 추적한다. 플로팅 팝업 메뉴는 화면상 어디에서든 나타날 수 있다.
CMenu::AppendMenu
BOOL AppendMenu( UINT nFlags, UINT nIDNewItem = 0, LPCTSTR lpszNewItem = NULL );
BOOL AppendMenu( UINT nFlags, UINT nIDNewItem, const CBitmap* pBmp );
반환값
함수가 성공적으로 수행되면 0이 아닌 값; 그렇지 않으면 0.
파라미터
nFlags 메뉴에 추가될 때 새 메뉴 아이템의 상태에 대한 정보를 지정한다. 이것은 아래 Remarks 부분에 열거된 값의 한가지이상으로 구성된다.
nIDNewItem 새 메뉴 아이템의 명령 ID 또는 nFlags가 MF_POPUP으로 설정되어있는 경우의 팝업 메뉴의 메뉴 핸들(HMENU)을 지정한다. 만약 nFlags가 MF_SEPARATOR로 설정되어있다면 nIDNewItem 파라미터는 무시된다(필요치 않다).
lpszNewItem 새 메뉴 아이템의 상태를 지정한다. nFlags 파라미터는 lpszNewItem을 다음의 방법으로 해석하는데 사용된다:
nFlags
|
lpszNewItem의 해석
|
MF_OWNERDRAW
|
메뉴 아이템과 관련된 추가 데이터를 포함하는데 사용될 수 있는32비트 값을 제공하는 응용프로그램을 포함한다. 32비트 값은WM_MEASUREITEM과 WM_DRAWITEM 메시지에 의해 제공된 구조체의 itemData 멤버내의 응용프로그램에 이용될 수 있다. 이 값은 메시지들과 함께 제공된 구조체의 itemData 멤버에 저장된다.
|
MF_STRING
|
널문자로 끝나는 문자열의 포인터를 포함한다. 이것이 디폴트 해석이다.
|
MF_SEPARATOR
|
lpszNewItem 파라미터가 무시된다(필요치 않다).
|
pBmp 메뉴 아이템으로써 사용될 CBitmap 객체의 포인터.
Remarks
메뉴의 끝에 새로운 아이템을 추가한다. 응용프로그램은 nFlags에 값을 설정함으로써 메뉴 아이템의 상태를 지정할 수있다. nIDNewItem이 팝업 메뉴를 지정할 때, 이것은 추가될 메뉴의 부분이 된다. 메뉴가 소멸된다면, 추가된 메뉴 또한 소멸된다. 추가된 메뉴는 충돌을 피하기 위해 CMenu객체로부터 분리되어야만 한다. MF_STRING과 MF_OWNERDRAW는AppendMenu의 비트맵 버전에 대해서는 유효하지 않다.
다음 목록은 nFlags에 설정될 수 있는 플래그들이다:
l MF_CHECKED 아이템 옆에 디폴트 체크 마크를 하기위해 MF_UNCHECKED와 함께 토글(toggle)로써 사용된다. 응용프로그램이 체크 마크 비트맵을 지원하면(SetMenuItemBitmaps 멤버 함수를 참고하라.), "체크 마크 켜짐(check mark on)" 비트맵이 디스플레이된다.
l MF_UNCHECKED 아이템 옆에 디폴트 체크 마크를 제거하기위해 MF_CHECKED와 함께 토글(toggle)로써 사용된다. 응용프로그램이 체크 마크 비트맵을 지원하면(SetMenuItemBitmaps 멤버 함수를 참고하라.), "체크 마크 꺼짐(check mark off)" 비트맵이 디스플레이된다.
l MF_DISABLED 메뉴 아이템을 사용 불능으로 만들어 선택될 수 없도록 한다. 그러나, 흐리게 하진 않다.
l MF_ENABLED 메뉴 아이템을 사용 가능으로 만들어 선택할 수 있도록 하고, 사용 불능 상태로부터 회복시킨다.
l MF_GRAYED 메뉴 아이템을 사용 불능으로 만들어 선택할 수도 없도록 하고, 흐리게 만든다.
l MF_MENUBARBREAK 새로운 라인에 아이템을 정적 메뉴로 대체하거나 새 열에 아이템을 팝업 메뉴 대신에 둔다.새 팝업 메뉴 열은 수직 분리하는 라인에 의해 이전 열에서 분리된다.
l MF_MENUBREAK 새 라인에 아이템을 정적 메뉴로 대체하거나 새 열에 아이템을 팝업 메뉴로 대체한다. 열 사이에 분리 라인은 없다.
l MF_OWNERDRAW 아이템을 오너-드로우 아이템으로 지정한다. 메뉴가 맨 처음 디스플레이될 때, 메뉴를 소유하는 윈도우는 메뉴 아이템의 폭과 높이를 검색하는WM_MEASUREITEM 메시지를 받는다. WM_DRAWITEM 메시지는소유자가 메뉴 아이템의 외형을 갱신할 때마다 발생한다. 이 홉션은 최상위 레벨의 메뉴 아이템에는 적용되지 않는다.
l MF_POPUP 연관된 팝업 메뉴를 가지는 메뉴 아이템을 지정한다. ID 파라미터는 아이템과 연관될 팝업 메뉴에 핸들을 지정한다. 이것은 탑 레벨 팝업 메뉴 또는 계층적 팝업 메뉴를 추가하기 위해 사용된다.
l MF_SEPARATOR 수평 분리 라인을 그린다. 팝업 메뉴 안에서만 사용될 수 있다. 이 라인은 흐려지거나, 사용 불능 또는 강조될 수 없다. 다른 파라미터는 무시된다.
l MF_STRING 문자 스트링이 있는 메뉴 아이템을 지정한다.
다음 그룹 각각은 함께 사용될 수 없고, 서로 배제되는 플래그 목록이다:
l MF_DISABLED, MF_ENABLED, 그리고 MF_GRAYED
l MF_STRING, MF_OWNERDRAW, MF_SEPARATOR, 그리고 비트맵 버전
l MF_MENUBARBREAK 그리고 MF_MENUBREAK
l MF_CHECKED 그리고 MF_UNCHECKED
윈도우에 상주하는 메뉴가 변경될 때마다(윈도우가 보여지거나 그렇지 않을 때) , 응용프로그램은 반드시CWnd::DrawMenuBar를 호출해야만 한다.
CMenu::CheckMenuItem
UINT CheckMenuItem( UINT nIDCheckItem, UINT nCheck );
반환값
아이템의 이전 상태: MF_CHECKED 또는 MF_UNCHECKED, 또는 메뉴 아이템이 존재하지 않으면0xFFFFFFFF.
파라미터
nIDCheckItem nCheck에 의해 결정되어, 체크될 메뉴 아이템을 지정한다.
nCheck 메뉴 아이템을 체크하는 방법과 메뉴에 아이템의 위치를 결정하는 방법을 지정한다. nCheck 파라미터는MF_BYPOSITION 또는 MF_BYCOMMAND 플래그를 가진 MF_CHECKED 또는 MF_UNCHECKED의 결합일 수 있다. 그것들은 다음과 같은 의미를 가진다:
l MF_BYCOMMAND 기존 메뉴 아이템의 명령ID를 부여하는 파라미터를 지정한다.
l MF_BYPOSITION 기존 메뉴 아이템의 위치를 부여하는 파라미터. 첫번째 파라미터는 0의 위치를 가진다.
l MF_CHECKED 아이템 옆에 디폴트 체크 표시를 놓기 위해 MF_UNCHECKED와 함께 토글로써 작동한다.
l MF_UNCHECKED 아이템 옆에 체크 표시를 제거하기 위해 MF_CHECKED와 함께 토글로써 작동한다.
Remarks
팝업 메뉴의 메뉴 아이템에 체크 마크를 추가하거나 제거한다. nIDCheckItem 파라미터는 수정될 아이템을 지정한다.
nIDCheckItem 파라미터는 메뉴 아이템뿐만 아니라 팝업 메뉴 아이템도 식별할 수 있다. 팝업 메뉴를 체크하기 위한 특별한 단계는 필요하지 않다. 최상위 레벨 메뉴 아이템은 체크될 수 없다. 팝업 메뉴 아이템은 그것과 연관된 메뉴 아이템 식별자를 갖지 않기 때문에 위치(position)에 의해 체크되어야 한다.
CMenu::CheckMenuRadioItem
BOOL CheckMenuRadioItem( UINT nIDFirst, UINT nIDLast, UINT nIDItem, UINT nFlags );
반환값
성공하면 0이 아닌 값; 아니면 0.
파라미터
nIDFirst 라디오 버튼 그룹에 있는 첫번째 메뉴 아이템을 지정한다.(nFlags의 값에 의존하는 ID 또는 옵셋으로써)
nIDLast 라디오 버튼 그룹에 있는 마지막 메뉴 아이템을 지정한다.(nFlags의 값에 의존하는 ID 또는 옵셋으로써)
nIDItem 라디오 버튼에 의해 체크될 그룹내에 있는 아이템을 지정한다.(nFlags의 값에 의존하는 ID 또는 옵셋으로써)
nFlags nIDFirst, nIDLast 그리고 nIDItem 을 다음과 같은 방법으로 해석한다:
nFlags
|
해석
|
MF_BYCOMMAND
|
파라미터가 기존의 메노 아이템의 명령 ID를 준다는 것을 지정한다. MF_BYCOMMAND 또는 MF_BYPOSITION 이 설정되어있지 않으면이것이 디폴트가 된다.
|
MF_BYPOSITION
|
파라미터가 있는 메뉴 아이템의 위치를 준다는 것을 지정한다. 첫번째 아이템은 0에 위치한다.
|
Remarks
지정된 메뉴 아이템을 체크하고 라디오 아이템을 만든다. 동시에, 관련 그룹 내의 다른 메뉴 아이템은 체크를 해제하고 라디오아이템 타입의 플래그를 없앤다. 체크된 아이템은 체크 마크 비트맵 대신에 라디오 버튼(작은 점)을 이용하여 표시된다.
CMenu::EnableMenuItem
UINT EnableMenuItem( UINT nIDEnableItem, UINT nEnable );
반환값
이전 상태(MF_DISABLED, MF_ENABLED, 또는 MF_GRAYED) 또는 유효하지 않은 경우는 –1.
파라미터
nIDEnableItem nEnable에 따라, 사용 가능하게 할 메뉴 아이템을 지정한다. 이 파라미터는 표준 메뉴 아이템 뿐만아니라 팝업 메뉴 아이템도 지정할 수 있다.
nEnable 실행할 동작을 지정한다. 이것은 MF_BYCOMMAND 또는 MF_BYPOSITION 과 MF_DISABLED, MF_ENABLED, 또는MF_GRAYED의 결합일 수 있다. 이러한 값은 비트 OR 연산에 의해 결합될 수 있다. 이것들은 다음과 같은 의미를 가지고 있다:
l MF_BYCOMMAND 기존 메뉴 아이템의 명령ID를 부여하는 파라미터를 지정한다.
l MF_BYPOSITION 기존 메뉴 아이템의 위치를 부여하는 파라미터. 첫번째 파라미터는 0의 위치를 가진다.
l MF_DISABLED 메뉴 아이템을 사용 불능으로 만들어 선택될 수 없도록 한다. 그러나, 흐리게 하진 않다.
l MF_ENABLED 메뉴 아이템을 사용 가능으로 만들어 선택할 수 있도록 하고, 사용 불능 상태로부터 회복시킨다.
l MF_GRAYED 메뉴 아이템을 사용 불능으로 만들어 선택할 수도 없도록 하고, 흐리게 만든다.
Remarks
메뉴 아이템을 활성화, 비활성화, 또는 흐리게 만든다. CreateMenu, InsertMenu, ModifyMenu, 그리고 LoadMenuIndirect멤버 함수에서도 메뉴 아이템의 상태(활성, 비활성, 흐리게)를 설정할 수 있다.
MF_BYPOSITION 값을 사용하여 응용프로그램이 정확한 CMenu를 사용하게 요구한다. 만약 메뉴바의 CMenu가 사용되면최상위 메뉴 아이템이 영향을 받게된다. 위치에 따라 팝업 메뉴나 중첩 팝업 메뉴에 있는 아이템의 상태를 설정하기 위해응용프로그램은 팝업 메뉴의 CMenu를 지정해 주어야 한다.
응용프로그램이 MF_BYCOMMAND 플래그를 설정하면, 윈도우는 CMenu에 종속된 팝업 메뉴, 아이템 모두를 체크한다. 그러므로, 중복 메뉴 아이템이 나타나지 않으면 메뉴 바의 CMenu를 사용하는 것으로도 충분하다.
CMenu::GetMenuItemCount
UINT GetMenuItemCount( ) const;
반환값
함수가 성공하면 메뉴의 아이템 개수; 그렇지 않으면 –1.
Remarks
팝업 또는 최상위 레벨 메뉴에 속한 아이템의 개수를 얻는다.
CMenu::GetMenuItemID
UINT GetMenuItemID( int nPos ) const;
반환값
함수가 성공하면 팝업 메뉴 내의 지정한 아이템의 ID. 만약 지정된 아이템이 팝업 메뉴라면(팝업 메뉴 내의 아이템이 아닌), 반환값은 -1이다. 만약 nPos가 SEPARATOR 메뉴 아이템을 가리키면 0을 반환한다.
파라미터
nPos 구하려는 ID를 가진 메뉴 아이템의 위치(0부터 시작)를 지정한다.
Remarks
nPos로 정의한 자리에 위치한 메뉴 아이템에 대한 메뉴 아이템 식별자를 얻는다.
CMenu::GetMenuState
UINT GetMenuState( UINT nID, UINT nFlags ) const;
반환값
지정한 아이템이 존재하지 않으면 0xFFFFFFFF을 반환. 만약 nID가 팝업 메뉴를 가리키면, 상위 바이트는 팝업 메뉴 내의아이템 수를 포함하고, 하위 바이트는 팝업 메뉴와 연관된 메뉴 플래그를 포함한다. 그렇지 않으면, 반환값은 다음 리스트에 있는 값의 마스크 값(논리값 OR)이다.(이 마스크는 nID가 지정하는 메뉴 아이템의 상태를 나타낸다.)
l MF_CHECKED 아이템 옆에 디폴트 체크 마크를 하기위해 MF_UNCHECKED와 함께 토글(toggle)로써 사용된다. 응용프로그램이 체크 마크 비트맵을 지원하면(SetMenuItemBitmaps 멤버 함수를 참고하라.), "체크 마크 켜짐(check mark on)" 비트맵이 디스플레이된다.
l MF_DISABLED 메뉴 아이템을 사용 불능으로 만들어 선택될 수 없도록 한다. 그러나, 흐리게 하진 않다.
l MF_ENABLED 메뉴 아이템을 사용 가능으로 만들어 선택할 수 있도록 하고, 사용 불능 상태로부터 회복시킨다. 이상수값이 0임을 명심하라; 이 값을 사용할 때 응용프로그램은 0에 대하여 테스트하면 안된다.
l MF_GRAYED 메뉴 아이템을 사용 불능으로 만들어 선택할 수도 없도록 하고, 흐리게 만든다.
l MF_MENUBARBREAK 새로운 라인에 아이템을 정적 메뉴로 대체하거나 새 열에 아이템을 팝업 메뉴 대신에 둔다.새 팝업 메뉴 열은 수직 분리하는 라인에 의해 이전 열에서 분리된다.
l MF_MENUBREAK 새 라인에 아이템을 정적 메뉴로 대체하거나 새 열에 아이템을 팝업 메뉴로 대체한다. 열 사이에 분리 라인은 없다.
l MF_SEPARATOR 수평 분리 라인을 그린다. 팝업 메뉴 안에서만 사용될 수 있다. 이 라인은 흐려지거나, 사용 불능 또는 강조될 수 없다. 다른 파라미터는 무시된다.
l MF_UNCHECKED 아이템 옆에 디폴트 체크 마크를 제거하기위해 MF_CHECKED와 함께 토글(toggle)로써 사용된다. 응용프로그램이 체크 마크 비트맵을 지원하면(SetMenuItemBitmaps 멤버 함수를 참고하라.), "체크 마크 꺼짐(check mark off)" 비트맵이 디스플레이된다. 이 상수값이 0임을 명심하라; 이 값을 사용할 때 응용프로그램은 0에대하여 테스트하면 안된다.
파라미터
nID nFlags에 의해 결정된 것에 따라, 메뉴 아이템의 ID를 지정한다.
nFlags nID의 속성을 지정한다. 이것은 다음 중에서 하나를 가질 수 있다:
l MF_BYCOMMAND 기존 메뉴 아이템의 명령ID를 부여하는 파라미터를 지정한다.
l MF_BYPOSITION 기존 메뉴 아이템의 위치를 부여하는 파라미터. 첫번째 파라미터는 0의 위치를 가진다.
Remarks
지정한 메뉴 아이템의 상태 또는 팝업 메뉴의 아이템 개수를 반환한다.
CMenu::GetMenuString
int GetMenuString( UINT nIDItem, LPTSTR lpString, int nMaxCount, UINT nFlags ) const;
int GetMenuString( UINT nIDItem, CString& rString, UINT nFlags ) const;
반환값
널 문자를 포함하지 않고, 버퍼에 복사된 실제 바이트 수.
파라미터
nIDItem nFlags에 따라 메뉴 아이템의 정수 식별자나 옵셋을 가리킨다.
lpString 레이블을 받기위한 버퍼의 포인터.
rString 복사된 메뉴 문자열을 받기 위한 CString 객체에 대한 참조.
nMaxCount 복사될 레이블의 바이트 단위 최대 길이를 지정. 만약 레이블이 nMaxCount에서 지정한 최대 숫자보다 길면, 나머지는 잘려버린다.
nFlags nItem을 어떻게 해석할 것인가를 지정하며 다음 중 하나의 값을 가진다:
nFlags
|
nIDItem의 해석
|
MF_BYCOMMAND
|
파라미터가 기존의 메뉴 아이템의 명령 ID를 준다는 것을 지정한다. MF_BYCOMMAND 또는 MF_BYPOSITION 가 설정되어있지 않다면 이것이 디폴트가 된다.
|
MF_BYPOSITION
|
파라미터가 기존의 메뉴 아이템의 위치를 준다는 것을 지정한다. 첫번째 아이템은 0에 위치한다.
|
Remarks
지정된 메뉴 아이템의 레이블을 지정된 버퍼에 복사한다.
nMaxCount 파라미터는 문자열의 종결을 나타내는 널문자까지 포함해야하므로 레이블의 문자수보다 더 큰 값을 가져야한다.
CMenu::GetSubMenu
CMenu* GetSubMenu( int nPos ) const;
반환값
만약 팝업 메뉴가 주어진 위치에 존재하면 팝업 메뉴의 핸들을 나타내는 m_hMenu 멤버를 가지는CMenu 객체의 포인터; 그렇지 않으면 NULL. 만약 CMenu 객체가 존재하지 않으면, 임시로 하나가 생성된다. 반환된 CMenu 포인터는 저장되어서는 안된다.
파라미터
nPos 메뉴에 포함된 팝업 메뉴의 위치를 지정. 첫번째 메뉴 아이템에 대해서 0이 부여된다. 팝업 메뉴의 식별자가 이 함수에사용되어서는 안된다.
Remarks
팝업 메뉴의 CMenu 객체를 얻는다.
CMenu::InsertMenu
BOOL InsertMenu( UINT nPosition, UINT nFlags, UINT nIDNewItem = 0, LPCTSTR lpszNewItem = NULL );
BOOL InsertMenu( UINT nPosition, UINT nFlags, UINT nIDNewItem, const CBitmap* pBmp );
반환값
함수가 성공하면 0이 아닌 값; 그렇지 않으면 0.
파라미터
nPosition 삽입될 메뉴 아이템 앞에 위치하는 메뉴 아이템을 지정. nFlags파라미터는 nPosition의 해석을 다음과 같은 방법으로 한다.:
nFlags
|
nPosition의 해석
|
MF_BYCOMMAND
|
파라미터가 기존의 메뉴 아이템의 명령 ID를 준다는 것을 지정한다. MF_BYCOMMAND 또는 MF_BYPOSITION 가 설정되어있지 않다면 이것이 디폴트가 된다.
|
MF_BYPOSITION
|
파라미터가 기존의 메뉴 아이템의 위치를 준다는 것을 지정한다. 첫번째 아이템은 0에 위치한다.
|
nFlags nPosition이 해석되는 방법을 지정하며 새로운 메뉴 아이템이 메뉴에 추가될 때 이 아이템의 상태 정보를 지정한다. 설정될 수 있는 플래그 리스트에 대해서는 AppendMenu 멤버 함수를 참조하라. 하나의 값 이상을 지정하기 위해서는 MF_BYCOMMAND 또는 MF_BYPOSITION 플래그와 비트 OR 연산을 이용하여 조합한다.
nIDNewItem 새로운 메뉴 아이템의 명령 ID를 지정하거나 nFlags가 MF_POPUP으로 설정되면 팝업 메뉴의 메뉴 핸들을지정한다. nFlags가 MF_SEPARATOR로 설정되면 이 파라미터는 무시된다.
lpszNewItem 새 메뉴 아이템을 지정한다. nFlags 파라미터는 이 변수를 해석하는 방법을 제공한다:
nFlags
|
lpszNewItem의 해석
|
MF_OWNERDRAW
|
메뉴 아이템과 관련된 추가 데이터를 포함하는데 사용될 수 있는 32비트 값을 제공하는 응용프로그램을 포함한다. 32비트 값은WM_MEASUREITEM과 WM_DRAWITEM 메시지에 의해 제공된 구조체의 itemData 멤버내의 응용프로그램에 이용될 수 있다. 이러한 메시지는 메뉴 아이템이 초기에 디스플레이 되거나 변경될 때 보내진다.
|
MF_STRING
|
널로 종결된 문자열에 대한 long 포인터를 포함한다. 이것이 디폴트 해석이다.
|
MF_SEPARATOR
|
lpszNewItem 파라미터를 무시한다(필요치 않다).
|
pBmp 메뉴 아이템으로 사용될 CBitmap 객체의 포인터
Remarks
nPosition에 의해 지정된 위치에 새로운 아이템을 삽입하고 다른 아이템은 아래로 이동로 이동시킨다. 응용프로그램은nFlags에서 값을 설정함으로써 메뉴 아이템의 상태를 지정할 수 있다.
윈도우에 상주하는 메뉴가 변경될 때마다 응용프로그램은 CWnd::DrawMenuBar를 호출해야만 한다.
nIDNewItem이 팝업 메뉴를 지정하면 이 팝업 메뉴는 삽입되는 메뉴의 일부분이 된다. 만약 메뉴가 소멸되면 삽입된 메뉴도 또한 소멸된다. 삽입된 메뉴는 충돌을 피하기 위해 CMenu 객체로부터 분리되어야 한다.
만약 다중 문서 인터페이스(MDI)의 활성 차일드 윈도우가 최대화되고 응용프로그램이 이 함수를 호출하고MF_BYPOSITION 플래그를 지정함으로써 MDI 응용프로그램의 메뉴에 팝업 메뉴를 삽입하면 예상했던 위치보다 멀리 떨어진 자리에 삽입되게 된다. 이것은 활성 차일드 윈도우의 콘트롤 메뉴가 MDI 프레임 윈도우 메뉴바의 첫번째 자리에 삽입되기 때문이다. 메뉴를 적절히 배치하려면 응용프로그램은 다른 것이 사용되지 않는 한 한자리 값에 1을 더해주어야한다. 응용프로그램은 WM_MDIGETACTIVE메시지를 사용하여 현재의 활성 차일드 윈도우가 최대화되었는지의 여부를 결정할 수 있다.
CMenu::ModifyMenu
BOOL ModifyMenu( UINT nPosition, UINT nFlags, UINT nIDNewItem = 0, LPCTSTR lpszNewItem = NULL );
BOOL ModifyMenu( UINT nPosition, UINT nFlags, UINT nIDNewItem, const CBitmap* pBmp );
반환값
함수가 성공하면 0이 아닌 값; 그렇지 않으면 0.
파라미터
nPosition 변경될 메뉴 아이템을 지정한다. nFlags 파라미터는 다음과 같은 방법으로 nPosition의 해석에 사용될 수 있다:
nFlags
|
nPosition의 해석
|
MF_BYCOMMAND
|
파라미터가 기존의 메뉴 아이템의 명령 ID를 준다는 것을 지정한다. MF_BYCOMMAND 또는 MF_BYPOSITION 가 설정되어있지 않다면 이것이 디폴트가 된다.
|
MF_BYPOSITION
|
파라미터가 기존의 메뉴 아이템의 위치를 준다는 것을 지정한다. 첫번째 아이템은 0에 위치한다.
|
nFlags nPosition이 해석되는 방법을 지정하고 메뉴 아이템의 변경 사항에 대한 정보를 지정한다. 설정될 수 있는 플래그의 리스트는 AppendMenu 멤버 함수를 참조하라.
nIDNewItem 새로운 메뉴 아이템의 명령 ID를 지정하거나 nFlags가 MF_POPUP으로 설정되면 팝업 메뉴의 메뉴 핸들을지정한다. nFlags가 MF_SEPARATOR로 설정되면 이 파라미터는 무시된다.
lpszNewItem 새 메뉴 아이템의 내용을 지정한다. nFlags 파라미터는 다음과 같은 방법으로 lpszNewItem의 해석에 사용될 수 있다:
nFlags
|
lpszNewItem의 해석
|
MF_OWNERDRAW
|
메뉴 아이템과 관련된 추가 데이터를 포함하는데 사용될 수 있는 32비트 값을 제공하는 응용프로그램을 포함한다. 이 32비트 값은MF_MEASUREITEM 과 MF_DRAWITEM을 응용프로그램이 다를 경우에유효하다.
|
MF_STRING
|
널문자로 끝나는 문자열이나 CString의 long 타입 포인터를 포함한다.
|
MF_SEPARATOR
|
lpszNewItem 파라미터가 무시된다(필요치 않다).
|
pBmp 메뉴 아이템으로 사용될 CBitmap 객체의 포인터
Remarks
nPosition에 의해 지정된 위치에 메뉴 아이템을 변경한다. 응용프로그램이 nFlags에서 값을 설정함으로써 메뉴 아이템의 새로운 상태를 지정할 수 있다. 만약 이 함수가 메뉴 아이템과 관련된 팝업 메뉴를 대체한다면 이전의 팝업 메뉴를 소멸시키고팝업 메뉴에 의해 사용되었던 메모리도 해제한다.
nIDNewItem이 팝업 메뉴를 지정하면 이 팝업 메뉴는 삽입되는 메뉴의 일부분이 된다. 만일 메뉴가 소멸되면 삽입된 팝업 메뉴도 소멸될 것이며 삽입된 메뉴는 충돌을 피하기위해 CMenu객체로부터 분리되어야 한다.
윈도우에 상주하는 메뉴가 변경될 때마다(윈도우가 디스플레이 되거나 안될 때) 응용프로그램은 CWnd::DrawMenuBar를호출해야만 한다. 기존 메뉴 아이템의 속성을 바꾸기위해서는 CheckMenuItem과 EnableMenuItem 멤버 함수를 이용하는것이 더 빠르다.
CMenu::RemoveMenu
BOOL RemoveMenu( UINT nPosition, UINT nFlags );
반환값
함수가 성공하면 0이 아닌 값; 그렇지 않으면 0.
파라미터
nPosition 변경될 메뉴 아이템을 지정한다. nFlags 파라미터는 다음과 같은 방법으로 nPosition의 해석에 사용될 수 있다:
nFlags
|
Interpretation of nPosition
|
MF_BYCOMMAND
|
파라미터가 기존의 메뉴 아이템의 명령 ID를 준다는 것을 지정한다. MF_BYCOMMAND 또는 MF_BYPOSITION 가 설정되어있지 않다면 이것이 디폴트가 된다.
|
MF_BYPOSITION
|
파라미터가 기존의 메뉴 아이템의 위치를 준다는 것을 지정한다. 첫번째 아이템은 0에 위치한다.
|
nFlags nPosition이 해석되는 방법을 지정한다.
Remarks
메뉴에서 팝업 메뉴와 관련된 메뉴 아이템을 삭제한다. 이것은 팝업 메뉴의 핸들을 소멸하는 것이 아니며, 그렇기 때문에메뉴는 재사용될 수 있다. 이 함수를 호출하기전에, 응용프로그램은 재사용을 위해 팝업 CMenu객체를 얻는GetSubMenu 함수를 호출한다.
윈도우에 상주하는 메뉴가 변경될 때마다(윈도우가 디스플레이 되거나 안될 때) 응용프로그램은 CWnd::DrawMenuBar를호출해야만 한다.
CMenu::SetMenuItemBitmaps
BOOL SetMenuItemBitmaps( UINT nPosition, UINT nFlags, const CBitmap* pBmpUnchecked, const CBitmap*pBmpChecked );
반환값
함수가 성공하면 0이 아닌 값; 그렇지 않으면 0.
파라미터
nPosition 변경될 메뉴 아이템을 지정한다. nFlags 파라미터는 다음과 같은 방법으로 nPosition의 해석에 사용될 수 있다:
nFlags
|
nPosition의 해석
|
MF_BYCOMMAND
|
파라미터가 기존의 메뉴 아이템의 명령 ID를 준다는 것을 지정한다. MF_BYCOMMAND 또는 MF_BYPOSITION 가 설정되어있지 않다면 이것이 디폴트가 된다.
|
MF_BYPOSITION
|
파라미터가 기존의 메뉴 아이템의 위치를 준다는 것을 지정한다. 첫번째 아이템은 0에 위치한다.
|
nFlags nPosition이 해석되는 방법을 지정한다.
pBmpUnchecked 체크되지 않은 메뉴 아이템에 사용할 비트맵을 지정한다.
pBmpChecked 체크할 메뉴 아이템에 사용할 비트맵을 지정한다.
Remarks
메뉴 아이템과 지정된 비트맵을 연관시킨다. 메뉴 아이템이 체크되었든 않았든, 윈도우는 메뉴 아이템 옆에 적절한 비트맵을출력한다.
만약 pBmpUnchecked 또는 pBmpChecked이 NULL이면, 윈도우는 일치하는 속성에 대한 메뉴 아이템 옆에 아무것도 출력하지 않는다. 만일 두 파리미터가 모두 NULL이면, 윈도우는 아이템이 체크될 때는 디폴트 체크마크를 사용하고 아이템의 체크를 없앨 때에는 체크 마크를 삭제한다.
메뉴가 소멸될 때 이러한 비트맵들은 같이 소멸하지 않는다; 응용프로그램은 반드시 이것을 소멸시켜야만 한다.
윈도우 GetMenuCheckMarkDimensions 함수는 메뉴 아이템을 위해 사용된 디폴트 체크 표시의 치수를 검색한다. 응용프로그램은 이 함수로 제공된 비트맵에 대한 적절한 크기를 결정하기위해 이러한 값들을 사용한다. 크기를 확보하고, 비트맵을 생성한 후, 그 값을 설정한다.
CMenu::GetMenuContextHelpId
DWORD GetMenuContextHelpId( ) const;
반환값
CMenu에 연결된 문맥 도움말 ID. 연결되어있지 않으면 0.
Remarks
CMenu에 연결된 문맥 도움말을 얻으려면 이 함수를 호출하라.
CMenu::SetMenuContextHelpId
BOOL SetMenuContextHelpId( DWORD dwContextHelpId );
반환값
함수가 성공하면 0이 아닌 값; 그렇지 않으면 0.
파라미터
dwContextHelpId CMenu에 연관된 문맥 도움말 ID.
Remarks
CMenu와 문맥 도움말 ID를 연관시키려면 이 함수를 호출하라. 메뉴에 있는 모든 아이템들이 이 식별자를 공유하게 된다.
CMenu::DrawItem
virtual void DrawItem( LPDRAWITEMSTRUCT lpDrawItemStruct );
파라미터
lpDrawItemStruct 요구되는 그리기 타입에 대한 정보를 가지고 있는 DRAWITEMSTRUCT 구조체의 포인터.
Remarks
소유 객체에 의해 그려진 메뉴의 모습을 변경할 때 프레임워크에 의해 호출된다. DRAWITEMSTRUCT 구조체의 ItemAction 멤버는 실행될 그리기 동작을 정의한다. 소유 객체에 의해 그려진 CMenu 객체에 대한 그리기를 수행하기 위해 이 멤버 함수를오버라이드 한다. 응용프로그램은 이 멤버 함수를 종료하기전에 lpDrawItemStruct에 제공된 디스플레이 컨텍스트를 위해 선택된 GDI 객체를 복원해야만 한다.
DRAWITEMSTRUCT 구조체에 대한 설명은 CWnd::OnDrawItem을 참조하라.
CMenu::MeasureItem
virtual void MeasureItem( LPMEASUREITEMSTRUCT lpMeasureItemStruct );
파라미터
lpMeasureItemStruct MEASUREITEMSTRUCT 구조체의 포인터
Remarks
소유 객체에 의해 그려진 메뉴가 생성될 때 프레임워크에 의해 호출된다. 디폴트로 이 멤버 함수는 아무 일도 하지 않는다. 윈도우에 메뉴의 치수를 알리려면 이 멤버 함수를 오버라이드하여 MEASUREITEMSTRUCT 구조체를 채워라.
MEASUREITEMSTRUCT 구조체에 대한 설명은 CWnd::OnMeasureItem 를 참조하라.
댓글 없음:
댓글 쓰기