CheckMenuItem 함수(winuser.h)

아티클
08/27/2023

[CheckMenuItem 은 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 SetMenuItemInfo를 사용합니다. ]

지정된 메뉴 항목의 검사 표시 특성의 상태를 선택 또는 지우기로 설정합니다.

구문

DWORD CheckMenuItem(
  [in] HMENU hMenu,
  [in] UINT  uIDCheckItem,
  [in] UINT  uCheck
);

매개 변수

[in] hMenu

형식: HMENU

관심 있는 메뉴에 대한 핸들입니다.

[in] uIDCheckItem

형식: UINT

uCheck 매개 변수에 의해 결정된 대로 검사 표시 특성을 설정할 메뉴 항목입니다.

[in] uCheck

형식: UINT

uIDCheckItem 매개 변수의 해석과 메뉴 항목의 검사 표시 특성의 상태를 제어하는 플래그입니다. 이 매개 변수는 MF_BYCOMMAND 또는 MF_BYPOSITION 및 MF_CHECKED 또는 MF_UNCHECKED 조합할 수 있습니다.

값	의미
MF_BYCOMMAND 0x00000000L	uIDCheckItem 매개 변수가 메뉴 항목의 식별자를 제공했음을 나타냅니다. MF_BYCOMMAND 플래그와 MF_BYPOSITION 플래그를 지정하지 않으면 MF_BYCOMMAND 플래그가 기본값 입니다.
MF_BYPOSITION 0x00000400L	uIDCheckItem 매개 변수가 메뉴 항목의 상대 위치를 0부터 시작했음을 나타냅니다.
MF_CHECKED 0x00000008L	검사 표시 특성을 선택한 상태로 설정합니다.
MF_UNCHECKED 0x00000000L	검사 표시 특성을 지우기 상태로 설정합니다.

반환 값

형식:DWORD

반환 값은 메뉴 항목의 이전 상태( MF_CHECKED 또는 MF_UNCHECKED)를 지정합니다. 메뉴 항목이 없으면 반환 값은 –1입니다.

설명

메뉴 모음의 항목에는 검사 표시가 있을 수 없습니다.

uIDCheckItem 매개 변수는 하위 메뉴 또는 명령 항목을 여는 항목을 식별합니다. 하위 메뉴가 열리는 항목의 경우 uIDCheckItem 매개 변수가 항목의 위치를 지정해야 합니다. 명령 항목의 경우 uIDCheckItem 매개 변수는 항목의 위치 또는 식별자를 지정할 수 있습니다.

예제

예제는 메뉴에서 확인란 시뮬레이션을 참조하세요.

요구 사항


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