EnableMenuItem

EnableMenuItem

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

BOOL EnableMenuItem(
    HMENU hMenu,    // 메뉴 핸들
    UINT  uItemID,  // 아이템의ID또는 위치
    UINT  uEnable   // 표시 상태
);

USER32.DLL

인수

hMenu

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

uItemID

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

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

uEnable

표시 상태 플래그 및 옵션 플래그를 조합해 지정합니다.

표시 상태는 다음의 어느쪽이든을 지정합니다.

치	의미
0x00000000 (MF_ENABLED)	아이템을 선택 가능하게 합니다.
0x00000001 (MF_GRAYED)	아이템을 회색으로 표시해, 선택 불가로 합니다.
0x00000002 (MF_DISABLED)	아이템을 선택 불가로 합니다.(회색 표시로는 되지 않습니다.)

옵션은 이하의 몇개의 값을 지정합니다.

치	의미
0x00000000 (MF_BYCOMMAND)	uItemID 파라미터는 메뉴 아이템의 ID 인 것을 지정합니다.
0x00000400 (MF_BYPOSITION)	uItemID 파라미터는 아이템의 위치의 인덱스인 것을 지정합니다.

반환값

성공하면 이전의 아이템의 표시 상태(MF_DISABLED, MF_ENABLED, MF_GRAYED 의 어느쪽이든)이 돌아갑니다.

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

대응 정보

Windows 95 이후 / Windows NT 3.1 이후