RemoveMenu 함수(winuser.h)

아티클
03/04/2024

메뉴 항목을 삭제하거나 지정된 메뉴에서 하위 메뉴를 분리합니다. 메뉴 항목이 드롭다운 메뉴 또는 하위 메뉴를 열면 RemoveMenu 는 메뉴 또는 핸들을 삭제하지 않으므로 메뉴를 다시 사용할 수 있습니다. 이 함수가 호출되기 전에 GetSubMenu 함수는 드롭다운 메뉴 또는 하위 메뉴에 대한 핸들을 검색해야 합니다.

구문

BOOL RemoveMenu(
  [in] HMENU hMenu,
  [in] UINT  uPosition,
  [in] UINT  uFlags
);

매개 변수

[in] hMenu

형식: HMENU

변경할 메뉴에 대한 핸들입니다.

[in] uPosition

형식: UINT

uFlags 매개 변수에 의해 결정된 대로 삭제할 메뉴 항목입니다.

[in] uFlags

형식: UINT

uPosition 매개 변수가 해석되는 방법을 나타냅니다. 이 매개 변수는 다음 값 중 하나여야 합니다.

값	의미
MF_BYCOMMAND 0x00000000L	uPosition이 메뉴 항목의 식별자를 제공했음을 나타냅니다. MF_BYCOMMAND 플래그와 MF_BYPOSITION 플래그를 지정하지 않으면 MF_BYCOMMAND 플래그가 기본 플래그입니다.
MF_BYPOSITION 0x00000400L	uPosition이 메뉴 항목의 상대 위치를 0부터 시작했음을 나타냅니다.

반환 값

형식: BOOL

함수가 성공하면 반환 값이 0이 아닙니다.

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

설명

메뉴가 표시된 창에 있는지 여부에 관계없이 메뉴가 변경될 때마다 애플리케이션에서 DrawMenuBar 함수를 호출해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-menu-l1-1-0(Windows 8 소개)