도구 모음

이 섹션에는 도구 모음 컨트롤과 함께 사용되는 프로그래밍 요소에 대한 정보가 포함되어 있습니다.

개요

주제	목차
도구 모음 컨트롤 정보	도구 모음은 하나 이상의 단추를 포함하는 컨트롤입니다. 사용자가 클릭하면 각 단추가 부모 창에 명령 메시지를 보냅니다. 일반적으로 도구 모음의 단추는 애플리케이션 메뉴의 항목에 해당하여 사용자가 애플리케이션의 명령에 액세스할 수 있는 보다 직접적인 추가 방법을 제공합니다.
도구 모음 컨트롤 사용하여	이 항목에는 애플리케이션에서 도구 모음 컨트롤을 사용하기 위한 구현 세부 정보 및 예제 코드가 포함되어 있습니다.

함수

주제	목차
CreateMappedBitmap	도구 모음에서 사용할 비트맵을 만듭니다.
CreateToolbarEx	도구 모음 창을 만들고 지정된 단추를 도구 모음에 추가합니다. 참고: 이 함수는 도구 모음의 모든 기능을 지원하지 않으므로 더 이상 사용되지 않습니다. 대신 CreateWindowEx 사용합니다. 예제는 도구 모음 컨트롤 사용하는참조하세요.

메시지

주제	목차
TB_ADDBITMAP	도구 모음에 사용할 수 있는 단추 이미지 목록에 하나 이상의 이미지를 추가합니다.
TB_ADDBUTTONS	도구 모음에 하나 이상의 단추를 추가합니다.
TB_ADDSTRING	도구 모음의 문자열 풀에 새 문자열을 추가합니다.
TB_AUTOSIZE	도구 모음의 크기를 조정합니다.
TB_BUTTONCOUNT	현재 도구 모음에 있는 단추 수를 검색합니다.
TB_BUTTONSTRUCTSIZE	TBBUTTON 구조체의 크기를 지정합니다.
TB_CHANGEBITMAP	도구 모음에서 단추의 비트맵을 변경합니다.
TB_CHECKBUTTON	도구 모음에서 지정된 단추를 확인하거나 선택 취소합니다.
TB_COMMANDTOINDEX	지정된 명령 식별자와 연결된 단추의 인덱스(0부터 시작하는 인덱스)를 검색합니다.
TB_CUSTOMIZE	사용자 지정 도구 모음 대화 상자를 표시합니다.
TB_DELETEBUTTON	도구 모음에서 단추를 삭제합니다.
TB_ENABLEBUTTON	도구 모음에서 지정된 단추를 사용하거나 사용하지 않도록 설정합니다.
TB_GETANCHORHIGHLIGHT	도구 모음의 앵커 강조 표시 설정을 검색합니다.
TB_GETBITMAP	도구 모음의 단추와 연결된 비트맵의 인덱스를 검색합니다.
TB_GETBITMAPFLAGS	사용할 비트맵의 형식을 설명하는 플래그를 검색합니다.
TB_GETBUTTON	도구 모음에서 지정된 단추에 대한 정보를 검색합니다.
TB_GETBUTTONINFO	도구 모음에서 단추에 대한 확장 정보를 검색합니다.
TB_GETBUTTONSIZE	도구 모음 단추의 현재 너비와 높이를 픽셀 단위로 검색합니다.
TB_GETBUTTONTEXT	도구 모음에서 단추의 표시 텍스트를 검색합니다.
TB_GETCOLORSCHEME	도구 모음 컨트롤에서 색 구성표 정보를 검색합니다.
TB_GETDISABLEDIMAGELIST	도구 모음 컨트롤이 비활성 단추를 표시하는 데 사용하는 이미지 목록을 검색합니다.
TB_GETEXTENDEDSTYLE	도구 모음 컨트롤의 확장 스타일을 검색합니다.
TB_GETHOTIMAGELIST	도구 모음 컨트롤이 핫 단추를 표시하는 데 사용하는 이미지 목록을 검색합니다.
TB_GETHOTITEM	도구 모음에서 핫 항목의 인덱스를 검색합니다.
TB_GETIDEALSIZE	도구 모음의 이상적인 크기를 가져옵니다.
TB_GETIMAGELIST	도구 모음 컨트롤이 단추를 기본 상태로 표시하는 데 사용하는 이미지 목록을 검색합니다. 도구 모음 컨트롤은 이 이미지 목록을 사용하여 단추가 핫 또는 비활성화되지 않은 경우 단추를 표시합니다.
TB_GETIMAGELISTCOUNT	도구 모음과 연결된 이미지 목록의 수를 가져옵니다.
TB_GETINSERTMARK	도구 모음의 현재 삽입 표시를 검색합니다.
TB_GETINSERTMARKCOLOR	도구 모음의 삽입 표시를 그리는 데 사용되는 색을 검색합니다.
TB_GETITEMDROPDOWNRECT	스타일이 BTNS_DROPDOWN도구 모음 항목에 대한 드롭다운 창의 경계 사각형을 가져옵니다.
TB_GETITEMRECT	도구 모음에서 단추의 경계 사각형을 검색합니다.
TB_GETMAXSIZE	도구 모음에서 표시되는 모든 단추와 구분 기호의 총 크기를 검색합니다.
TB_GETMETRICS	도구 모음 컨트롤의 메트릭을 검색합니다.
TB_GETOBJECT	도구 모음 컨트롤에 대한 IDropTarget 검색합니다.
TB_GETPADDING	도구 모음 컨트롤의 안쪽 여백을 검색합니다.
TB_GETPRESSEDIMAGELIST	도구 모음 컨트롤이 단추를 누른 상태로 표시하는 데 사용하는 이미지 목록을 가져옵니다.
TB_GETRECT	지정된 도구 모음 단추의 경계 사각형을 검색합니다.
TB_GETROWS	TBSTYLE_WRAPABLE 스타일을 사용하여 도구 모음의 단추 행 수를 검색합니다.
TB_GETSTATE	도구 모음에서 지정한 단추의 상태(예: 활성화, 누름 또는 선택 여부)에 대한 정보를 검색합니다.
TB_GETSTRING	도구 모음의 문자열 풀에서 문자열을 검색합니다.
TB_GETSTYLE	도구 모음 컨트롤에 현재 사용 중인 스타일을 검색합니다.
TB_GETTEXTROWS	도구 모음 단추에 표시할 수 있는 최대 텍스트 행 수를 검색합니다.
TB_GETTOOLTIPS	도구 모음과 연결된 도구 설명 컨트롤(있는 경우)에 대한 핸들을 검색합니다.
TB_GETUNICODEFORMAT	컨트롤의 유니코드 문자 형식 플래그를 검색합니다.
TB_HASACCELERATOR	내부용; 애플리케이션에서 사용하지 않는 것이 좋습니다. 지정된 액셀러레이터 문자가 있는 도구 모음 단추 수를 검색합니다.
TB_HIDEBUTTON	도구 모음에서 지정된 단추를 숨기거나 표시합니다.
TB_HITTEST	도구 모음 컨트롤에 점이 있는 위치를 결정합니다.
TB_INDETERMINATE	도구 모음에서 지정된 단추의 확정되지 않은 상태를 설정하거나 지웁니다.
TB_INSERTBUTTON	도구 모음에 단추를 삽입합니다.
TB_INSERTMARKHITTEST	도구 모음의 한 지점에 대한 삽입 표시 정보를 검색합니다.
TB_ISBUTTONCHECKED	도구 모음에서 지정된 단추가 선택되어 있는지 여부를 확인합니다.
TB_ISBUTTONENABLED	도구 모음에서 지정된 단추를 사용할 수 있는지 여부를 확인합니다.
TB_ISBUTTONHIDDEN	도구 모음에서 지정된 단추가 숨겨져 있는지 여부를 확인합니다.
TB_ISBUTTONHIGHLIGHTED	도구 모음 단추의 강조 표시 상태를 확인합니다.
TB_ISBUTTONINDETERMINATE	도구 모음의 지정된 단추가 확정되지 않았는지 여부를 확인합니다.
TB_ISBUTTONPRESSED	도구 모음에서 지정된 단추를 누를지 여부를 결정합니다.
TB_LOADIMAGES	시스템 정의 단추 이미지를 도구 모음 컨트롤의 이미지 목록에 로드합니다.
TB_MAPACCELERATOR	지정된 액셀러레이터 문자에 해당하는 단추의 ID를 결정합니다.
TB_MARKBUTTON	도구 모음 컨트롤에서 지정된 단추의 강조 표시 상태를 설정합니다.
TB_MOVEBUTTON	한 인덱스에서 다른 인덱스로 단추를 이동합니다.
TB_PRESSBUTTON	도구 모음에서 지정된 단추를 누르거나 놓습니다.
TB_REPLACEBITMAP	기존 비트맵을 새 비트맵으로 대체합니다.
TB_SAVERESTORE	이 메시지를 보내 도구 모음 상태 저장 또는 복원을 시작합니다.
TB_SETANCHORHIGHLIGHT	도구 모음의 앵커 강조 표시 설정을 설정합니다.
TB_SETBITMAPSIZE	도구 모음에 추가할 비트맵 이미지의 크기를 설정합니다.
TB_SETBOUNDINGSIZE	내부용; 애플리케이션에서 사용하지 않는 것이 좋습니다. 다중 열 도구 모음 컨트롤의 경계 크기를 설정합니다.
TB_SETBUTTONINFO	도구 모음의 기존 단추에 대한 정보를 설정합니다.
TB_SETBUTTONSIZE	도구 모음의 단추 크기를 설정합니다.
TB_SETBUTTONWIDTH	도구 모음 컨트롤의 최소 및 최대 단추 너비를 설정합니다.
TB_SETCMDID	도구 모음 단추의 명령 식별자를 설정합니다.
TB_SETCOLORSCHEME	도구 모음 컨트롤의 색 구성표 정보를 설정합니다.
TB_SETDISABLEDIMAGELIST	도구 모음 컨트롤이 비활성화된 단추를 표시하는 데 사용할 이미지 목록을 설정합니다.
TB_SETDRAWTEXTFLAGS	도구 모음의 텍스트 그리기 플래그를 설정합니다.
TB_SETEXTENDEDSTYLE	도구 모음 컨트롤의 확장 스타일을 설정합니다.
TB_SETHOTIMAGELIST	도구 모음 컨트롤이 핫 단추를 표시하는 데 사용할 이미지 목록을 설정합니다.
TB_SETHOTITEM	도구 모음에서 핫 항목을 설정합니다.
TB_SETHOTITEM2	도구 모음에서 핫 항목을 설정합니다.
TB_SETIMAGELIST	도구 모음에서 기본 상태의 단추를 표시하는 데 사용하는 이미지 목록을 설정합니다.
TB_SETINDENT	도구 모음 컨트롤의 첫 번째 단추에 대한 들여쓰기를 설정합니다.
TB_SETINSERTMARK	도구 모음의 현재 삽입 표시를 설정합니다.
TB_SETINSERTMARKCOLOR	도구 모음의 삽입 표시를 그리는 데 사용되는 색을 설정합니다.
TB_SETLISTGAP	특정 도구 모음의 도구 모음 단추 사이의 거리를 설정합니다.
TB_SETMAXTEXTROWS	도구 모음 단추에 표시되는 최대 텍스트 행 수를 설정합니다.
TB_SETMETRICS	도구 모음 컨트롤의 메트릭을 설정합니다.
TB_SETPADDING	도구 모음 컨트롤의 안쪽 여백을 설정합니다.
TB_SETPARENT	도구 모음 컨트롤이 알림 코드를 보내는 창을 설정합니다.
TB_SETPRESSEDIMAGELIST	도구 모음에서 누름 상태의 단추를 표시하는 데 사용하는 이미지 목록을 설정합니다.
TB_SETROWS	도구 모음의 단추 행 수를 설정합니다.
TB_SETSTATE	도구 모음에서 지정된 단추의 상태를 설정합니다.
TB_SETSTYLE	도구 모음 컨트롤의 스타일을 설정합니다.
TB_SETTOOLTIPS	도구 설명 컨트롤을 도구 모음과 연결합니다.
TB_SETUNICODEFORMAT	컨트롤의 유니코드 문자 형식 플래그를 설정합니다. 이 메시지를 사용하면 컨트롤을 다시 만들지 않고 런타임에 컨트롤에서 사용하는 문자 집합을 변경할 수 있습니다.
TB_SETWINDOWTHEME	도구 모음 컨트롤의 비주얼 스타일을 설정합니다.
TB_TRANSLATEACCELERATOR	도구 모음에 키보드 메시지를 전달합니다.

알림을

주제	목차
NM_CHAR(도구 모음)	WM_CHAR 메시지를 받으면 도구 모음에서 보냅니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
NM_CLICK(도구 모음)	사용자가 마우스 왼쪽 단추가 있는 항목을 클릭할 때 도구 모음 컨트롤에서 보냅니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
NM_CUSTOMDRAW(도구 모음)	그리기 작업에 대해 부모 창에 알리기 위해 도구 모음에서 보냅니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
NM_DBLCLK(도구 모음)	사용자가 컨트롤 내에서 마우스 왼쪽 단추를 두 번 클릭했음을 도구 모음 컨트롤의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
NM_KEYDOWN(도구 모음)	컨트롤에 키보드 포커스가 있고 사용자가 키를 누르면 컨트롤에서 전송됩니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
NM_LDOWN	왼쪽 마우스 단추를 눌렀다는 것을 도구 모음의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
NM_RCLICK(도구 모음)	사용자가 마우스 오른쪽 단추로 도구 모음을 클릭할 때 도구 모음 컨트롤에서 전송됩니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
NM_RDBLCLK(도구 모음)	사용자가 컨트롤 내에서 마우스 오른쪽 단추를 두 번 클릭했음을 컨트롤의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
NM_RELEASEDCAPTURE(도구 모음)	도구 모음 컨트롤의 부모 창에 컨트롤이 마우스 캡처를 해제하고 있음을 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
NM_TOOLTIPSCREATED(도구 모음)	도구 모음이 도구 설명 컨트롤을 만들었다는 것을 도구 모음의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_BEGINADJUST	사용자가 도구 모음 사용자 지정을 시작했다는 것을 도구 모음의 부모 창에 알립니다. 이 메시지 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_BEGINDRAG	도구 모음의 부모 창에 사용자가 도구 모음에서 단추를 끌기 시작했음을 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_CUSTHELP	도구 모음 사용자 지정 대화 상자에서 사용자가 도움말 단추를 선택했음을 도구 모음의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_DELETINGBUTTON	단추를 삭제하려고 할 때 도구 모음 컨트롤에서 보냅니다.
TBN_DRAGOUT	사용자가 단추를 클릭한 다음 단추에서 커서를 이동할 때 도구 모음 컨트롤에서 보냅니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_DRAGOVER	끌어서 놓고 있는 단추에 대해 TB_MARKBUTTON 메시지를 보내야 하는지 여부를 확인합니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_DROPDOWN	사용자가 드롭다운 단추를 클릭할 때 도구 모음 컨트롤에서 보냅니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_DUPACCELERATOR	둘 이상의 활성 도구 모음에서 액셀러레이터 키를 사용할 수 있는지 여부를 확인합니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_ENDADJUST	도구 모음의 부모 창에 사용자가 도구 모음 사용자 지정을 중지했음을 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_ENDDRAG	도구 모음의 부모 창에 사용자가 도구 모음의 단추 끌기를 중지했음을 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_GETBUTTONINFO	도구 모음 사용자 지정 정보를 검색하고 도구 모음의 부모 창에 도구 모음의 변경 내용을 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_GETDISPINFO	도구 모음 항목에 대한 표시 정보를 검색합니다. 이 알림은 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_GETINFOTIP	도구 모음 항목에 대한 정보 설명 정보를 검색합니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_GETOBJECT	포인터가 단추 중 하나를 통과할 때 TBSTYLE_REGISTERDROP 스타일을 사용하여 놓기 대상 개체를 요청하는 도구 모음 컨트롤에서 보냅니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_HOTITEMCHANGE	핫(강조 표시된) 항목이 변경될 때 도구 모음 컨트롤에서 보냅니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_INITCUSTOMIZE	사용자 지정이 시작되었음을 도구 모음의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_MAPACCELERATOR	지정된 액셀러레이터 문자에 해당하는 도구 모음에서 단추의 인덱스를 요청합니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_QUERYDELETE	사용자가 도구 모음을 사용자 지정하는 동안 도구 모음에서 단추를 삭제할 수 있는지 여부를 도구 모음의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_QUERYINSERT	사용자가 도구 모음을 사용자 지정하는 동안 지정된 단추의 왼쪽에 단추를 삽입할 수 있는지 여부를 도구 모음의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_RESET	도구 모음의 부모 창에 사용자가 도구 모음 사용자 지정 대화 상자의 콘텐츠를 다시 설정했음을 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_RESTORE	도구 모음이 복원 중임을 도구 모음의 부모 창에 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_SAVE	도구 모음의 부모 창에 도구 모음이 저장 중임을 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_TOOLBARCHANGE	도구 모음의 부모 창에 사용자가 도구 모음을 사용자 지정했음을 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_WRAPACCELERATOR	지정된 액셀러레이터 문자에 해당하는 하나 이상의 도구 모음에서 단추의 인덱스를 요청합니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
TBN_WRAPHOTITEM	두 개 이상의 도구 모음이 있는 애플리케이션에 핫 항목이 변경되도록 알립니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.

구조

주제	목차
COLORMAP	CreateMappedBitmap 함수에서 비트맵의 색을 매핑하는 데 사용하는 정보를 포함합니다.
NMTBCUSTOMDRAW	도구 모음 컨트롤에서 보낸 NM_CUSTOMDRAW 알림 코드와 관련된 정보를 포함합니다.
NMTBDISPINFO	도구 모음 항목에 대한 표시 정보를 포함하고 받습니다. 이 구조는 TBN_GETDISPINFO 알림 코드와 함께 사용됩니다.
NMTBGETINFOTIP	도구 모음 항목에 대한 정보 설명 정보를 포함하고 받습니다. 이 구조는 TBN_GETINFOTIP 알림 코드와 함께 사용됩니다.
NMTBHOTITEM	TBN_HOTITEMCHANGE 알림 코드와 함께 사용되는 정보를 포함합니다.
NMTBRESTORE	애플리케이션에서 도구 모음 상태가 저장되었을 때 NMTBSAVE 배치된 정보를 추출할 수 있습니다. 이 구조는 TBN_RESTORE 알림 코드를 받으면 애플리케이션에 전달됩니다.
NMTBSAVE	이 구조는 TBN_SAVE 알림 코드를 받으면 애플리케이션에 전달됩니다. 현재 저장 중인 단추에 대한 정보가 포함되어 있습니다. 애플리케이션은 멤버의 값을 수정하여 추가 정보를 저장할 수 있습니다.
NMTOOLBAR	도구 모음 알림 코드를 처리하는 데 사용되는 정보를 포함합니다. 이 구조체는 TBNOTIFY 구조체를 대체합니다.
TBADDBITMAP	단추 이미지가 포함된 비트맵을 도구 모음에 추가합니다.
TBBUTTON	도구 모음의 단추에 대한 정보를 포함합니다.
TBBUTTONINFO	도구 모음의 특정 단추에 대한 정보를 포함하거나 받습니다.
TBINSERTMARK	도구 모음 컨트롤의 삽입 표시에 대한 정보를 포함합니다.
TBMETRICS	도구 모음 항목을 축소하거나 확장하는 데 사용되는 도구 모음의 메트릭을 정의합니다.
TBREPLACEBITMAP	TB_REPLACEBITMAP 메시지와 함께 한 도구 모음 비트맵을 다른 도구 모음 비트맵으로 바꾸는 데 사용됩니다.
TBSAVEPARAMS	TB_SAVERESTORE 메시지가 저장되고 도구 모음의 상태에 대한 정보를 검색하는 레지스트리의 위치를 지정합니다.

상수

주제	목차
도구 모음 단추 상태	이 섹션에서는 도구 모음 단추에 사용할 수 있는 상태를 나열합니다.
도구 모음 컨트롤 및 단추 스타일	다음 창 스타일은 도구 모음에만 적용됩니다. 도구 모음을 만들 때 다른 창 스타일과 결합됩니다. 참고버전 6.00경우 도구 모음에서 비주얼 스타일 사용하는 경우 단추는 스타일 설정에 관계없이 항상 투명합니다. 그렇지 않으면 투명도 동작은 TBSTYLE_FLAT 또는 TBSTYLE_TRANSPARENT 스타일을 사용하여 표시된 대로 정상입니다. 참고: Comctl32.dll 버전 6은 재배포할 수 없지만 Windows 이상 버전에 포함되어 있습니다. Comctl32.dll 버전 6을 사용하려면 매니페스트에 지정합니다. 매니페스트에 대한 자세한 내용은 비주얼 스타일사용하도록 설정하세요.
도구 모음 확장 스타일	이 섹션에서는 도구 모음 컨트롤에서 지원하는 확장 스타일을 나열합니다.
도구 모음 표준 단추 이미지 인덱스 값	이 섹션에서는 표준 비트맵 내에 있는 이미지의 인덱스 값을 지정합니다.