CreatePopupMenu 함수(winuser.h)

드롭다운 메뉴, 하위 메뉴 또는 바로 가기 메뉴를 만듭니다. 메뉴는 처음에 비어 있습니다. InsertMenuItem 함수를 사용하여 메뉴 항목을 삽입하거나 추가할 수 있습니다. InsertMenu 함수를 사용하여 메뉴 항목을 삽입하고 AppendMenu 함수를 사용하여 메뉴 항목을 추가할 수도 있습니다.

구문

HMENU CreatePopupMenu();

반환 값

형식: HMENU

함수가 성공하면 반환 값은 새로 만든 메뉴에 대한 핸들입니다.

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

설명

애플리케이션은 기존 메뉴에 새 메뉴를 추가하거나 TrackPopupMenuEx 또는 TrackPopupMenu 함수를 호출하여 바로 가기 메뉴를 표시할 수 있습니다.

창에 할당된 메뉴와 연결된 리소스는 자동으로 해제됩니다. 메뉴가 창에 할당되지 않은 경우 애플리케이션은 닫기 전에 메뉴와 연결된 시스템 리소스를 해제해야 합니다. 애플리케이션은 DestroyMenu 함수를 호출하여 메뉴 리소스를 해제합니다.

예제

예제는 메뉴에 선 및 그래프 추가를 참조하세요.

요구 사항


지원되는 최소 클라이언트	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에 도입됨)