다음을 통해 공유

도구 모음

  • 아티클

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

개요

항목 콘텐츠
Toolbar 컨트롤 정보 도구 모음은 하나 이상의 단추를 포함하는 컨트롤입니다. 각 단추는 사용자가 클릭하면 부모 창에 명령 메시지를 보냅니다. 일반적으로 도구 모음에 있는 단추는 애플리케이션의 메뉴 항목과 일치하며, 사용자가 애플리케이션의 명령을 보다 직접적으로 사용할 수 있게 해줍니다.
도구 모음 컨트롤 사용 이 항목에는 애플리케이션에서 도구 모음 컨트롤을 사용하기 위한 구현 세부 정보 및 예제 코드가 포함되어 있습니다.

Functions

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

메시지

항목 콘텐츠
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을 사용하려면 매니페스트에 지정합니다. 매니페스트에 대한 자세한 내용은 시각적 스타일 사용을 참조하세요.
도구 모음 확장 스타일 이 섹션에서는 도구 모음 컨트롤에서 지원하는 확장 스타일을 나열합니다.
도구 모음 표준 단추 이미지 인덱스 값 이 섹션에서는 표준 비트맵 내 이미지의 인덱스 값을 명시합니다.