CMenu::AppendMenu

아티클
02/21/2013

메뉴의 끝에 새 항목을 추가합니다.

BOOL AppendMenu(
   UINT nFlags,
   UINT_PTR nIDNewItem = 0,
   LPCTSTR lpszNewItem = NULL 
);
BOOL AppendMenu(
   UINT nFlags,
   UINT_PTR nIDNewItem,
   const CBitmap* pBmp 
);

매개 변수

nFlags
이 메뉴에 추가 될 때 새 메뉴 항목의 상태에 대 한 정보를 지정 합니다.주의 섹션에 나열 된 값 중 하나 이상으로 구성 됩니다.
nIDNewItem
새 메뉴 항목의 명령 ID를 지정 또는 if nFlags 설정 MF_POPUP, 메뉴 핸들 (HMENU)의 팝업 메뉴.nIDNewItem 매개 변수는 무시 (필요 없음) 경우 nFlags 설정 MF_SEPARATOR.

lpszNewItem
새 메뉴 항목의 내용을 지정합니다.nFlags 매개 변수를 해석 하는 데 사용 lpszNewItem 에서는 다음과 같이 합니다.

nFlags	Lpsznewitem의 해석
MF_OWNERDRAW	응용 프로그램 메뉴 항목과 연결 된 추가 데이터를 유지 하는 데 사용할 수 있는 응용 프로그램 제공 32 비트 값을 포함 합니다.처리할 때이 32 비트 응용 프로그램에 사용할 수 있는 값인 WM_MEASUREITEM 및 WM_DRAWITEM 메시지.값이 저장 되는 itemData 메시지를 제공 하는 구조체의 멤버.
MF_STRING	Null로 끝나는 문자열에 대 한 포인터를 포함 합니다.이 기본 해석입니다.
MF_SEPARATOR	lpszNewItem (필요 하지 않은) 매개 변수가 무시 됩니다.

pBmp
가리키는 있는 CBitmap 개체 메뉴 항목으로 사용 됩니다.

반환 값

함수가 성공 하면 0이 아닌. 그렇지 않으면 0입니다.

설명

응용 프로그램에서 값을 설정 하 여 메뉴 항목의 상태를 지정할 수 있습니다 nFlags.때 nIDNewItem 팝업 메뉴에서 지정 추가 되는 메뉴에 포함 됩니다.해당 메뉴를 소멸 하는 경우 추가 된 메뉴도 소멸 됩니다.에 추가 된 메뉴에서 끊어야는 CMenu 개체 충돌을 피하기 위해.이때 MF_STRING 및 MF_OWNERDRAW 의 비트맵 버전에 대 한 잘못 된 AppendMenu.

다음 목록에서 설정할 수 있는 플래그에 설명 nFlags.

MF_CHECKED 로 전환으로 서 역할을 MF_UNCHECKED 항목 옆에 있는 기본 확인란을 선택 합니다.때 응용 프로그램 제공 확인 표시가 비트맵 (참조는 SetMenuItemBitmaps 멤버 함수), "확인란에" 비트맵 표시 됩니다.
MF_UNCHECKED 로 전환으로 서 역할을 MF_CHECKED 항목 옆에 확인 표시를 제거 합니다.때 응용 프로그램 제공 확인 표시가 비트맵 (참조는 SetMenuItemBitmaps 멤버 함수), "확인란 해제" 비트맵 표시 됩니다.
MF_DISABLED 선택할 수 없습니다 하지만 흐리게 표시 하지 않도록 메뉴 항목을 사용할 수 없습니다.
MF_ENABLED선택 하 고 흐리게 표시 된 상태에서 복원 될 수 있도록 메뉴 항목이 있습니다.
MF_GRAYED 선택할 수 없습니다 하 고 흐리게 표시 하 여 메뉴 항목을 사용할 수 없습니다.
MF_MENUBARBREAK 항목이 정적 메뉴 또는 팝업 메뉴에서 새 열 새 줄에 배치 합니다.세로 구분선으로 새 팝업 메뉴 열 이전 열에서 나뉩니다.
MF_MENUBREAK 항목이 정적 메뉴 또는 팝업 메뉴에서 새 열 새 줄에 배치 합니다.구분 선이 없습니다 열 사이 배치 됩니다.
MF_OWNERDRAW항목 소유자 그리기 항목이 됩니다.메뉴에 처음으로 표시 되 면 메뉴를 소유 하는 창 수신은 WM_MEASUREITEM 메뉴 항목의 너비와 높이 검색 하는 메시지.WM_DRAWITEM 메시지 보낸 모양 메뉴 항목의 소유자를 업데이트 해야 할 때마다입니다.이 옵션은 최상위 메뉴 항목에 대해 올바르지 않습니다.
MF_POPUP 팝업 메뉴에 연결 된 메뉴 항목을 갖도록 지정 합니다.ID 매개 변수 항목에 연결할 수 있는 팝업 메뉴에 대 한 핸들을 지정 합니다.이 최상위 팝업 메뉴 또는 팝업 메뉴 계층 구조 팝업 메뉴 항목을 추가 하는 데 사용 됩니다.
MF_SEPARATOR 가로 구분선을 그립니다.팝업 메뉴에서 사용할 수 있습니다.이 줄이 흐리게, 비활성화 하거나 강조 표시 될 수 없습니다.다른 매개 변수는 무시 됩니다.
MF_STRING 메뉴 항목 문자열 임을 지정 합니다.