TB_ADDBUTTONS 메시지

도구 모음에 하나 이상의 단추를 추가합니다.

매개 변수

wParam

추가할 단추 수입니다.

lParam

추가할 단추에 대한 정보가 포함된 TBBUTTON 구조체의 배열에 대한 포인터입니다. 배열에는 wParam에 의해 지정된 단추와 같은 수의 요소가 있어야 합니다.

반환 값

성공하면 TRUE를 반환하고 그렇지 않으면 FALSE를 반환합니다.

설명

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

하나 이상의 이미지 목록에서 도구 모음 단추에 비트맵을 할당하는 방법에 대한 설명은 TB_SETIMAGELIST를 참조하세요.

예제

다음 코드 예는 보기 단추에 대한 표준 시스템 비트맵을 사용하여 도구 모음에 세 개의 단추를 추가합니다. TB_ADDBITMAP 메시지는 이미지 목록 내 첫 번째 단추 이미지의 인덱스를 반환합니다. 개별 이미지는 해당 값의 오프셋으로 식별됩니다.

TBADDBITMAP tbAddBitmap;
tbAddBitmap.hInst = HINST_COMMCTRL;
tbAddBitmap.nID = IDB_VIEW_SMALL_COLOR;

// There are 12 items in IDB_VIEW_SMALL_COLOR.  However, because this is a standard
// system-defined bitmap, the wParam (nButtons) is ignored.
//
// hWndToolbar is the handle of the toolbar window.
//
// Do not forget to send TB_BUTTONSTRUCTSIZE if the toolbar was created
// by using CreateWindowEx.
//
int stdidx = SendMessage(hWndToolbar, TB_ADDBITMAP, 0, (LPARAM)&tbAddBitmap);

// Define the buttons. 
// IDM_SETLARGEICONVIEW and so on are application-defined command IDs.

const int numButtons = 3;
TBBUTTON tbButtonsAdd[numButtons] = 
{
    {stdidx + VIEW_LARGEICONS, IDM_SETLARGEICONVIEW, TBSTATE_ENABLED, BTNS_BUTTON},
    {stdidx + VIEW_SMALLICONS, IDM_SETSMALLICONVIEW, TBSTATE_ENABLED, BTNS_BUTTON},
    {stdidx + VIEW_DETAILS, IDM_SETDETAILSVIEW, TBSTATE_ENABLED, BTNS_BUTTON}
}; 

// Add the view buttons.
SendMessage(hWndToolbar, TB_ADDBUTTONS, numButtons, (LPARAM)tbButtonsAdd);

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
헤더	Commctrl.h
유니코드 및 ANSI 이름	TB_ADDBUTTONSW(유니코드) 및 TB_ADDBUTTONSA(ANSI)

추가 정보

도구 모음 표준 단추 이미지 인덱스 값