CreateMappedBitmap 함수(commctrl.h)

도구 모음에서 사용할 비트맵을 만듭니다.

구문

HBITMAP CreateMappedBitmap(
       HINSTANCE  hInstance,
       INT_PTR    idBitmap,
       UINT       wFlags,
  [in] LPCOLORMAP lpColorMap,
       int        iNumMaps
);

매개 변수

hInstance

형식: HINSTANCE

비트맵 리소스가 포함된 실행 파일로 instance 모듈에 대한 핸들입니다.

idBitmap

형식: INT_PTR

비트맵 리소스의 리소스 식별자입니다.

wFlags

형식: UINT

비트맵 플래그입니다. 이 매개 변수는 0 또는 다음 값일 수 있습니다.

값	의미
CMB_MASKED	비트맵을 마스크로 사용합니다.

[in] lpColorMap

형식: LPCOLORMAP

비트맵을 매핑하는 데 필요한 색 정보를 포함하는 COLORMAP 구조체에 대한 포인터입니다. 이 매개 변수가 NULL이면 함수는 기본 색 맵을 사용합니다.

iNumMaps

형식: int

lpColorMap이 가리키는 색 맵의 수입니다.

반환 값

형식: HBITMAP

성공하면 비트맵에 대한 핸들을 반환하고, 그렇지 않으면 NULL 을 반환합니다. 확장된 오류 정보를 검색하려면 GetLastError를 호출합니다.

설명

함수는 비트맵 리소스 및 색 매핑 정보로 지정된 비트맵 데이터와 색을 사용하여 새 비트맵을 만듭니다.

이 함수는 색 맵이 있는 이미지에 대해서만 완전히 지원됩니다. 즉, 색이 256개 이하인 이미지입니다.

예제

다음 예제 코드는 리소스에서 비트맵을 만들고 단추 면의 시스템 색에 매핑하여 검은색을 투명하게 표시합니다.

DWORD backgroundColor = GetSysColor(COLOR_BTNFACE);
COLORMAP colorMap;
colorMap.from = RGB(0, 0, 0);
colorMap.to = backgroundColor;
HBITMAP hbm = CreateMappedBitmap(g_hInst, IDB_BITMAP1, 0, &colorMap, 1);

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	commctrl.h
라이브러리	Comctl32.lib
DLL	Comctl32.dll
API 세트	ext-ms-win-shell-comctl32-init-l1-1-1(Windows 10 버전 10.0.14393에 도입됨)