InsertMenu

InsertMenu 함수 다른 항목을 이동 하는 메뉴 아래로 메뉴에 새 메뉴 항목을 삽입.

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

(BOOL InsertMenu HMENU  hMenu, / / 메뉴 핸들UINTuPosition, / / 새 메뉴 항목을 메뉴 항목 앞에UINTuFlags, / / 메뉴 항목 플래그UINTuIDNewItem, / / 메뉴 항목 식별자 또는 드롭 다운 처리 / / 메뉴 또는 하위 메뉴LPCTSTRlpNewItem / / 메뉴 항목 내용);

매개 변수

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

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

반환 값

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

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

주의

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

다음 목록에는 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 가로 구분선을 그립니다. 이 플래그는 드롭 다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴에만 사용 됩니다. 줄을 회색으로 비활성화 하거나 강조 수 없습니다. LpNewItem 및 uIDNewItem 매개 변수는 무시 됩니다.
MF_STRING 메뉴 항목 텍스트 문자열; 되도록 지정 합니다. lpNewItem 매개 변수 문자열을 가리킵니다.
MF_UNCHECKED (기본값) 메뉴 항목 옆에 확인 표시가 배치 하지 않습니다. 응용 프로그램 확인 표시 비트맵 ( SetMenuItemBitmaps 함수 참조)가 제공 하는 경우이 플래그 메뉴 항목 옆에 확인 되지 않은 비트맵 표시.

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

Windows CE: Windows CE는 uFlags 매개 변수에서 MF_BITMAP 플래그 또는 MF_DISABLED 플래그를 지원 하지 않습니다. 메뉴 항목은 비활성화 되 고 하지 않고 비활성화할 수 없습니다. 메뉴 항목을 MF_GRAYED 플래그를 사용 하지 않으려면.

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

참고 항목

메뉴 개요 메뉴 기능, AppendMenu, DeleteMenu, DrawMenuBar, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps, WM_DRAWITEM, WM_MEASUREITEM

 

Index