SetMenuItemBitmaps 함수(winuser.h)

  • 아티클

지정된 비트맵을 메뉴 항목과 연결합니다. 메뉴 항목을 선택하거나 선택 취소할지 여부에 관계없이 시스템은 메뉴 항목 옆에 적절한 비트맵을 표시합니다.

구문

BOOL SetMenuItemBitmaps(
  [in]           HMENU   hMenu,
  [in]           UINT    uPosition,
  [in]           UINT    uFlags,
  [in, optional] HBITMAP hBitmapUnchecked,
  [in, optional] HBITMAP hBitmapChecked
);

매개 변수

[in] hMenu

형식: HMENU

새 검사 표시 비트맵을 받을 항목이 포함된 메뉴에 대한 핸들입니다.

[in] uPosition

형식: UINT

uFlags 매개 변수에 의해 결정된 대로 변경할 메뉴 항목입니다.

[in] uFlags

형식: UINT

uPosition 매개 변수를 해석하는 방법을 지정합니다. uFlags 매개 변수는 다음 값 중 하나여야 합니다.

값 의미
MF_BYCOMMAND
0x00000000L
 uPosition이 메뉴 항목의 식별자를 제공했음을 나타냅니다. MF_BYCOMMAND 또는 MF_BYPOSITION 지정되지 않은 경우 MF_BYCOMMAND 기본 플래그입니다.
MF_BYPOSITION
0x00000400L
 uPosition이 메뉴 항목의 상대 위치를 0부터 시작했음을 나타냅니다.

[in, optional] hBitmapUnchecked

형식: HBITMAP

메뉴 항목을 선택하지 않을 때 표시되는 비트맵에 대한 핸들입니다.

[in, optional] hBitmapChecked

형식: HBITMAP

메뉴 항목을 선택할 때 표시되는 비트맵에 대한 핸들입니다.

반환 값

형식: BOOL

함수가 성공하면 반환 값이 0이 아닙니다.

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

설명

hBitmapUnchecked 또는 hBitmapChecked 매개 변수가 NULL인 경우 시스템은 해당 검사 상태의 메뉴 항목 옆에 아무 것도 표시하지 않습니다. 두 매개 변수가 모두 NULL인 경우 시스템은 항목을 선택할 때 기본 검사 표시 비트맵을 표시하고 항목을 선택하지 않으면 비트맵을 제거합니다.

메뉴가 제거되면 이러한 비트맵은 제거되지 않습니다. 그것은 그들을 파괴하는 응용 프로그램에 달려있다.

선택한 비트맵과 지우기 비트맵은 단색이어야 합니다. 시스템은 부울 AND 연산자를 사용하여 비트맵을 메뉴와 결합하여 흰색 부분이 투명해지고 검은색 부분이 메뉴 항목 색이 되도록 합니다. 색 비트맵을 사용하는 경우 결과가 바람직하지 않을 수 있습니다.

getSystemMetrics 함수를 SM_CXMENUCHECK 및 SM_CYMENUCHECK 값과 함께 사용하여 비트맵 차원을 검색합니다.

예제

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

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 winuser.h(Windows.h 포함)
라이브러리 User32.lib
DLL User32.dll

참고 항목

메뉴