AppendMenu

AppendMenu 함수는 지정한 메뉴 모음, 드롭 다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴의 끝에 새 항목을 추가합니다. 이 함수를 사용 하 여 콘텐츠, 모양 및 메뉴 항목의 동작을 지정 하려면.

AppendMenu 함수 InsertMenuItem 함수에 의해 대체 되었습니다. 그러나 계속 사용할 수 있습니다 AppendMenu,, 만약 당신이 InsertMenuItem 의 확장 기능 필요 하지 않습니다.

 (BOOL AppendMenu HMENU  hMenu, / / 변경 메뉴에 대 한 핸들UINTuFlags, / / 메뉴 항목 플래그UINTuIDNewItem, / / 메뉴 항목 식별자 또는 드롭 다운 메뉴 또는 하위 메뉴 핸들LPCTSTRlpNewItem / / 메뉴 항목 내용);
 

매개 변수

hMenu
메뉴 모음, 드롭 다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴를 변경할 수에 대 한 핸들.
uFlags
모양 및 새 메뉴 항목의 동작을 제어 하는 플래그를 지정 합니다. 이 매개 변수는 다음 주의 섹션에 나열 된 값의 조합이 될 수 있습니다.
uIDNewItem
새 메뉴 항목의 식별자를 지정 합니다 또는 uFlags 매개 변수가 MF_POPUP, 드롭다운 메뉴 또는 하위 메뉴에 대 한 핸들을 설정 하는 경우.
lpNewItem
새 메뉴 항목의 콘텐츠를 지정합니다. LpNewItem 의 해석 여부 uFlags 매개 변수 같이 MF_BITMAP, MF_OWNERDRAW, 또는 MF_STRING 플래그를 포함에 따라 달라 집니다.:
설명
MF_BITMAP 비트맵 핸들 포함.
MF_OWNERDRAW 메뉴 항목에 관련 된 추가 데이터를 유지 하기 위해 사용할 수 있는 응용 프로그램에 의해 제공 되는 32 비트 값을 포함 합니다. 구조는 WM_MEASURE의 lparam 매개 변수에서 가리키는 또는 메뉴 생성 될 때의 모양을 업데이트를 보낸 WM_DRAWITEM 메시지의 itemData 구성원의 값은.
MF_STRING Null로 끝나는 문자열에 대 한 포인터를 포함합니다.

반환 값

함수가 성공 하면 반환 값은 0이 아닌.

함수가 실패 하면 반환 값은 0입니다. 확장 된 오류 정보를 얻을 하려면 GetLastError.

주의

응용 프로그램 메뉴가 표시 창에 여부 메뉴 변경 될 때마다 DrawMenuBar 함수를 호출 해야 합니다.

비트맵 또는 소유자가 그린 메뉴 항목이 작동 하도록 키보드 액셀러레이터를 얻으려면, 메뉴의 소유자 WM_MENUCHAR 메시지를 처리 해야 합니다. 자세한 내용은 Owner-Drawn 메뉴와 WM_MENUCHAR 메시지를 참조 하십시오.

UFlags 매개 변수에서 다음 플래그를 설정할 수 있습니다.:

설명
MF_BITMAP 메뉴 항목으로 비트맵을 사용합니다. LpNewItem 매개 변수는 비트맵에 대 한 핸들을 포함.
MF_CHECKED 메뉴 항목 옆에 확인 표시가 배치합니다. 응용 프로그램 제공 ( SetMenuItemBitmaps이 플래그 표시 메뉴 항목 옆에 확인 표시가 비트맵을 참조 하는 확인 표시 비트맵 경우.
MF_DISABLED 그래서 그것을 선택할 수 없습니다, 하지만 깃발을 통해이 회색 수 없습니다 메뉴 항목 비활성화.
MF_ENABLED 그래서 그것을 선택할 수 있습니다 회색된 상태에서 복원 메뉴 항목 활성화.
MF_GRAYED 메뉴 항목을 비활성화 하 고 선택할 수 있도록 회색.
MF_MENUBARBREAK 함수는 MF_MENUBREAK와 같은 메뉴 모음에 대 한 플래그. 드롭 다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴에 대 한 새 열이 구분 이전 열에서 수직 라인.
MF_MENUBREAK (메뉴 모음)에 대 한 새 줄에 항목을 배치 또는 열 구분 없이 새 열 (에-드롭 다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴).
MF_OWNERDRAW 항목 소유자가 그린 항목으로 지정 합니다. 메뉴를 처음으로 표시 되기 전에 메뉴를 소유 하는 창 너비와 메뉴 항목의 높이 검색 하려면 WM_MEASUREITEM 메시지를 받습니다. 메뉴 항목의 모양을 업데이트 합니다 때마다 WM_DRAWITEM 메시지 다음 소유자 창의 창 프로시저에 전송 됩니다.
MF_POPUP 지정 메뉴 항목 드롭 다운 메뉴 또는 하위 메뉴를 엽니다. UIDNewItem 매개 변수 드롭 다운 메뉴 또는 하위 메뉴에 대 한 핸들을 지정합니다. 메뉴 모음 또는 메뉴 항목을 드롭다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴에 하위 메뉴에 메뉴 이름을 추가 하려면이 플래그를 사용.
MF_SEPARATOR 가로 구분선을 그립니다. 이 플래그는 드롭 다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴에만 사용 됩니다. 줄을 회색으로 비활성화 하거나 강조 수 없습니다. LpNewItemuIDNewItem 매개 변수는 무시 됩니다.
MF_STRING 메뉴 항목 텍스트 문자열; 되도록 지정 합니다. lpNewItem 매개 변수 문자열을 가리킵니다.
MF_UNCHECKED (기본값) 항목 옆에 확인 표시가 배치 하지 않습니다. 응용 프로그램 확인 표시 비트맵 ( SetMenuItemBitmaps참조), 공급 하는 경우이 플래그 메뉴 항목 옆에 확인 되지 않은 비트맵 표시.

다음 플래그 그룹을 함께 사용할 수 없습니다.:

Windows CE: 다음 플래그는 fuFlags 매개 변수는 지원 되지 않습니다.

MF_BITMAP

MF_DISABLED

MFS_GRAYED

MF_DISABLED 및 MFS_GRAYED 대신 MF_GRAYED는 사용할 수 있습니다.

Windows CE 1.0는 계단식 메뉴를 지원 하지 않습니다. 다른 팝업 메뉴에 MF_POPUP 메뉴를 삽입할 수 없습니다 Windows CE 1.0을 사용 하는 경우.

다음 플래그가 지원 되지 않습니다 Windows CE 1.0:

MF_POPUP

MF_MENUBREAK

MF_MENUBARBREAK

Windows CE 버전 2.0 이상에서는이 플래그가 지원 됩니다. 계단식 메뉴도 지원.

참고 항목

메뉴 개요 메뉴 기능 CreateMenu, DeleteMenu, DestroyMenu, DrawMenuBar, InsertMenu, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps

 

Index