GetSystemMenu 함수(winuser.h)

아티클
03/09/2024

애플리케이션이 복사 및 수정을 위해 창 메뉴(시스템 메뉴 또는 컨트롤 메뉴라고도 함)에 액세스할 수 있도록 합니다.

구문

HMENU GetSystemMenu(
  [in] HWND hWnd,
  [in] BOOL bRevert
);

매개 변수

[in] hWnd

형식: HWND

창 메뉴의 복사본을 소유할 창에 대한 핸들입니다.

[in] bRevert

형식: BOOL

수행할 작업입니다. 이 매개 변수가 FALSE이면 GetSystemMenu 는 현재 사용 중인 창 메뉴의 복사본에 대한 핸들을 반환합니다. 복사본은 처음에는 창 메뉴와 동일하지만 수정할 수 있습니다. 이 매개 변수가 TRUE이면 GetSystemMenu 는 창 메뉴를 다시 기본 상태로 다시 설정합니다. 이전 창 메뉴(있는 경우)가 제거됩니다.

반환 값

형식: HMENU

bRevert 매개 변수가 FALSE이면 반환 값은 창 메뉴의 복사본에 대한 핸들입니다. bRevert 매개 변수가 TRUE이면 반환 값은 NULL입니다.

설명

GetSystemMenu 함수를 사용하여 창 메뉴의 자체 복사본을 만들지 않는 모든 창은 표준 창 메뉴를 받습니다.

창 메뉴에는 처음에 SC_CLOSE, SC_MOVE 및SC_SIZE 같은 다양한 식별자 값이 있는 항목이 포함되어 있습니다.

창 메뉴의 메뉴 항목은 WM_SYSCOMMAND 메시지를 보냅니다.

미리 정의된 모든 창 메뉴 항목에는 식별자 번호가 0xF000보다 큽니다. 애플리케이션이 창 메뉴에 명령을 추가하는 경우 0xF000 미만의 식별자 번호를 사용해야 합니다.

시스템은 상황에 따라 표준 창 메뉴에서 항목을 자동으로 회색으로 표시합니다. 애플리케이션은 메뉴가 표시되기 전에 전송되는 WM_INITMENU 메시지에 응답하여 자체 검사 또는 회색을 수행할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	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 소개)