TB_ADDBITMAP 메시지

도구 모음에 사용할 수 있는 단추 이미지 목록에 하나 이상의 이미지를 추가합니다.

매개 변수

wParam

비트맵의 단추 이미지 수입니다. lParam이 시스템 정의 비트맵을 지정하는 경우 이 매개 변수는 무시됩니다.

lParam

비트맵 리소스의 식별자와 비트맵 리소스가 포함된 실행 파일이 있는 모듈 인스턴스에 대한 핸들을 포함하는 TBADDBITMAP 구조체에 대한 포인터입니다.

반환 값

성공하면 첫 번째 새 이미지의 인덱스를 반환하고 그렇지 않으면 -1을 반환합니다.

설명

도구 모음이 CreateWindowEx 함수를 사용하여 만들어진 경우 TB_ADDBITMAP을 보내기 전에 도구 모음에 TB_BUTTONSTRUCTSIZE 메시지를 보내야 합니다.

예제

다음 예에서는 리소스(IDB_BITMAP1)에서 비트맵을 만들고 배경색(이 경우 검은색)을 시스템 단추 면 색에 매핑한 다음 도구 모음에 추가합니다.

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);
TBADDBITMAP tb;
tb.hInst = NULL;
tb.nID = (UINT_PTR)hbm;

// hWndToolbar is the window handle of the toolbar.
// Do not forget to send TB_BUTTONSTRUCTSIZE if the toolbar was 
// created by using CreateWindowEx.
int index = SendMessage (hWndToolbar, TB_ADDBITMAP, 0, (LPARAM)&tb);

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
헤더	Commctrl.h