CheckMenuItem

CheckMenuItem

메뉴 아이템의 체크 마크의 표시 상태를 변경합니다.

이 함수는 SetMenuItemInfo함수에 교체되었습니다만, 아직 사용할 수 있습니다.

DWORD CheckMenuItem(
    HMENU hMenu,    // 메뉴 핸들
    UINT  uItemID,  // 아이템의ID또는 위치
    UINT  uCheck    // 체크 마크의 표시 상태
);

USER32.DLL

인수

hMenu

메뉴의 핸들을 지정합니다.

uItemID

아이템ID(을)를 지정합니다.

uCheck파라미터에0x00000400 (MF_BYPOSITION) 하지만 지정되어 있는 경우는, 아이템의 위치를 지정합니다.

uCheck

체크 마크의 표시 상태를 지정합니다.다음의 어느쪽이든을 지정합니다.

0x00000000 (MF_UNCHECKED)

아이템에 체크 마크를 붙이지 않습니다.

0x00000008 (MF_CHECKED)

아이템에 체크 마크를 붙입니다.

아이템을 지정하는 방법을 나타내는 이하의 값의 어느쪽이든을 조합해 지정합니다.

0x00000000 (MF_BYCOMMAND)

uItemID파라미터는 메뉴 아이템ID(을)를 나타냅니다.

0x00000400 (MF_BYPOSITION)

uItemID파라미터는 아이템의 위치의 인덱스를 나타냅니다.

반환값

성공하면 이전의 아이템의 체크 마크의 표시 상태(MF_CHECKED, MF_UNCHECKED의 어느쪽이든)이 돌아갑니다.

실패하면-1하지만 돌아갑니다.

해설

도구모음의 아이템에 체크 마크를 붙일 수 없습니다.

부메뉴를 여는 아이템을 지정하는 경우에는, 아이템의 위치의 인덱스를 지정하지 않으면 안됩니다.커멘드 아이템을 지정하는 경우에는, 아이템의 위치의 인덱스와 커멘드ID의 어디에서 지정할 수도 있습니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후