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 [데스크톱 앱만 해당] |
| 헤더 |
|
| 유니코드 및 ANSI 이름 |
TB_ADDBUTTONSW(유니코드) 및 TB_ADDBUTTONSA(ANSI) |