ModifyMenu

ModifyMenu 함수는 기존 메뉴 항목을 변경합니다. 이 기능은 콘텐츠, 모양 및 메뉴 항목의 동작을 지정 하는 데.

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

(BOOL ModifyMenu HMENU  hMnu, / / 메뉴 핸들UINTuPosition, / / 메뉴 항목 수정UINTuFlags, / / 메뉴 항목 플래그UINTuIDNewItem, / / 메뉴 항목 식별자 또는 드롭 다운 처리 / / 메뉴 또는 하위 메뉴LPCTSTRlpNewItem / / 메뉴 항목 내용);
 

매개 변수

hMnu
변경 메뉴에 대 한 핸들.
uPosition
UFlags 매개 변수에 의해 결정 된 대로 메뉴 항목을을 변경할 수를 지정 합니다.
uFlags
UPosition 매개 변수는 콘텐츠, 모양 및 메뉴 항목의 동작의 해석을 제어 하는 플래그를 지정 합니다. 이 매개 변수는 다음 필수 값 중 하나 및 다음 주의 섹션에 나열 된 값 중 하나 이상의 조합 이어야 합니다.
의미
MF_BYCOMMAND UPosition 매개 변수 제공 메뉴 항목의 식별자를 나타냅니다. MF_BYCOMMAND 플래그는 기본 MF_BYCOMMAND도 MF_BYPOSITION 플래그를 지정 하는 경우.
MF_BYPOSITION UPosition 매개 변수 제공 메뉴 항목의 0부터 시작 상대적 위치를 나타냅니다.

uIDNewItem
수정된 메뉴 항목의 식별자를 지정 합니다 또는 uFlags 매개 변수는 MF_POPUP 플래그 설정, 드롭다운 메뉴 또는 하위 메뉴에 대 한 핸들.
lpNewItem
변경된 메뉴 항목의 콘텐츠를 포인터입니다. 이 매개 변수를 해석 uFlags 매개 변수는 MF_BITMAP, MF_OWNERDRAW, 또는 MF_STRING 플래그를 포함 하는 여부에 따라 달라 집니다.
의미
MF_BITMAP 비트맵 핸들 포함.
MF_OWNERDRAW 메뉴 항목에 관련 된 추가 데이터를 유지 하는 데 사용 하는 응용 프로그램에 의해 제공 되는 32 비트 값을 포함 합니다. 값은 WM_MEASUREITEMlparam 매개 변수에서 가리키는 구조 또는 메뉴 항목을 만든 모양을 업데이트 될 때 전송 되는 WM_DRAWITEM 메시지의 itemData 구성원의.
MF_STRING Null로 끝나는 문자열 (기본값)에 대 한 포인터를 포함합니다.

반환 값

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

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

주의

함수 이전 드롭 다운 메뉴 또는 하위 메뉴를 파괴 하 고 그것에 의해 사용 되는 메모리를 해제 ModifyMenu 드롭 다운 메뉴 또는 하위 메뉴를 열고 메뉴 항목을 대체 하는 경우.

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

응용 프로그램 메뉴가 표시 창에 여부 메뉴 변경 될 때마다 DrawMenuBar 함수를 호출 해야 합니다. 기존 메뉴 항목의 속성을 변경 하려면 그것은 CheckMenuItemEnableMenuItem 함수를 사용 하는 것이 빠릅니다.

다음 목록에는 uFlags 매개 변수에서 설정할 수 있는 플래그에 설명:

의미
MF_BITMAP 메뉴 항목으로 비트맵을 사용합니다. LpNewItem 매개 변수는 비트맵에 대 한 핸들을 포함.
MF_BYCOMMAND UPosition 매개 변수 (기본값) 메뉴 항목의 식별자를 지정 합니다 나타냅니다.
MF_BYPOSITION UPosition 매개 변수 새 메뉴 항목의 0부터 시작 상대 위치 지정을 나타냅니다.
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 함수 참조)가 제공 하는 경우이 플래그 메뉴 항목 옆에 확인 되지 않은 비트맵 표시.

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

참고 항목

메뉴 개요 메뉴 기능, AppendMenu, CheckMenuItem, DrawMenuBar, EnableMenuItem, SetMenuItemBitmaps, SetMenuItemInfo, WM_DRAWITEM, WM_MEASUREITEM

 

Index