도구 모음 컨트롤 및 단추 스타일

  • 아티클

다음 창 스타일은 도구 모음에만 적용됩니다. 도구 모음을 만들 때 다른 창 스타일과 결합됩니다.

참고 Common Controls 버전 6.00의 경우 시각적 스타일이 도구 모음과 함께 사용되는 경우 단추는 스타일 설정에 관계없이 항상 투명합니다. 그렇지 않으면 TBSTYLE_FLAT 또는 TBSTYLE_TRANSPARENT 스타일을 사용하여 표시된 대로 투명도 동작이 정상입니다.

참고

Comctl32.dll 버전 6은 재배포할 수 없지만 Windows에 포함되어 있습니다. Comctl32.dll 버전 6을 사용하려면 매니페스트에 지정합니다. 매니페스트에 대한 자세한 내용은 시각적 스타일 사용을 참조하세요.

상수 설명
TBSTYLE_ALTDRAG
 사용자가 ALT 키를 누른 상태에서 도구 모음 단추를 끌어서 도구 모음 단추의 위치를 변경할 수 있습니다. 이 스타일이 지정되지 않은 경우 사용자는 SHIFT 키를 누른 상태에서 단추를 끌어야 합니다. 도구 모음 단추를 끌려면 CCS_ADJUSTABLE 스타일을 지정해야 합니다.
TBSTYLE_CUSTOMERASE
 버전 4.70. 도구 모음이 WM_ERASEBKGND 메시지를 처리할 때 NM_CUSTOMDRAW 알림 코드를 생성합니다.
TBSTYLE_FLAT
 버전 4.70. 플랫 도구 모음을 만듭니다. 플랫 도구 모음에서는 도구 모음과 단추가 모두 투명하고 핫 추적이 사용하도록 설정됩니다. 단추 텍스트는 단추 비트맵 아래에 나타납니다. 다시 그리기 문제를 방지하려면 도구 모음 컨트롤이 표시되기 전에 이 스타일을 설정해야 합니다.
TBSTYLE_LIST
 버전 4.70. 비트맵 오른쪽에 단추 텍스트가 있는 플랫 도구 모음을 만듭니다. 그렇지 않으면 이 스타일은 TBSTYLE_FLAT과 동일합니다. 다시 그리기 문제를 방지하려면 도구 모음 컨트롤이 표시되기 전에 이 스타일을 설정해야 합니다.
TBSTYLE_REGISTERDROP
 버전 4.71. 커서가 도구 모음 단추 위로 지나갈 때 놓기 대상 개체를 요청하는 TBN_GETOBJECT 알림 코드를 생성합니다.
TBSTYLE_TOOLTIPS
 애플리케이션이 도구 모음의 단추에 대한 설명 텍스트를 표시하는 데 사용할 수 있는 도구 설명 컨트롤을 만듭니다.
TBSTYLE_TRANSPARENT
 버전 4.71. 투명한 도구 모음을 만듭니다. 투명 도구 모음에서 도구 모음은 투명하지만 단추는 투명하지 않습니다. 단추 텍스트는 단추 비트맵 아래에 나타납니다. 다시 그리기 문제를 방지하려면 도구 모음 컨트롤이 표시되기 전에 이 스타일을 설정해야 합니다.
TBSTYLE_WRAPABLE
 여러 줄의 단추를 가질 수 있는 도구 모음을 만듭니다. 도구 모음이 너무 좁아서 같은 줄에 있는 모든 단추를 포함할 수 없을 때 도구 모음 단추는 다음 줄로 "줄 바꿈"할 수 있습니다. 도구 모음이 래핑되면 막대에 구분 기호가 없는 경우 가장 오른쪽 구분 기호 또는 가장 오른쪽 단추에서 중단이 발생합니다. 이 스타일은 도구 모음이 수직 rebar 컨트롤의 파트일 때 수직 도구 모음 컨트롤을 표시하도록 설정되어야 합니다. 이 스타일은 CCS_VERT와 결합할 수 없습니다.

참고: 도구 모음 단추는 다음 스타일의 조합을 가질 수 있습니다. 단추 스타일을 지정하려면 단추 TBBUTTON 구조체의 fsStyle 멤버에 적절한 플래그를 설정합니다. 모든 스타일을 결합할 수 있는 것은 아닙니다.

Shell 버전 4.72 및 이전 버전의 경우 창 및 단추 스타일 플래그는 모두 TBSTYLE_XXX 형식이었습니다. Commctrl.h의 버전 4.72 이하로 애플리케이션을 컴파일하는 경우 TBSTYLE_XXX 단추 스타일 플래그를 사용해야 합니다. 버전 5.80 이상에서는 모든 단추 스타일의 형식이 BTNS_XXX입니다. 모든 TBSTYLE_XXX 값은 동일한 의미와 숫자 값을 갖는 동등한 BTNS_XXX 값을 가집니다. 편의를 위해 다음 표에 두 가지 형식을 모두 제공합니다.

상수 설명
BTNS_AUTOSIZE
 버전 5.80. 도구 모음 컨트롤이 단추에 표준 너비를 할당하지 않도록 할당합니다. 대신 단추의 너비는 텍스트 너비와 단추 이미지를 더한 값을 기준으로 계산됩니다. 버전 4.72 이하에서는 동등한 스타일 플래그인 TBSTYLE_AUTOSIZE를 사용합니다.
BTNS_BUTTON
 버전 5.80. 표준 단추를 만듭니다. 버전 4.72 이하에서는 동등한 스타일 플래그인 TBSTYLE_BUTTON을 사용합니다. 이 플래그는 0으로 정의되며 다른 플래그가 설정되지 않았음을 나타내는 데 사용해야 합니다.
BTNS_CHECK
 버전 5.80. 사용자가 클릭할 때마다 누른 상태와 누르지 않은 상태 사이를 전환하는 이중 상태 누름 단추를 만듭니다. 단추가 눌린 상태일 때 단추의 배경색이 다릅니다. 버전 4.72 및 이전 버전에는 동등한 스타일 플래그인 TBSTYLE_CHECK를 사용합니다.
BTNS_CHECKGROUP
 버전 5.80. 옵션 단추(라디오 단추이라고도 함)과 유사하게 그룹의 다른 단추를 누를 때까지 누른 상태를 유지하는 단추를 만듭니다. BTNS_CHECK와 BTNS_GROUP을 결합한 것과 같습니다. 버전 4.72 이하에서는 동등한 스타일 플래그인 TBSTYLE_CHECKGROUP을 사용합니다.
BTNS_DROPDOWN
 버전 5.80. 단추를 클릭하면 목록을 표시할 수 있는 드롭다운 스타일 단추를 만듭니다. 일반 단추에 사용되는 WM_COMMAND 메시지 대신 드롭다운 단추가 TBN_DROPDOWN 알림 코드를 보냅니다. 그런 다음 애플리케이션은 알림 처리기가 옵션 목록을 표시하도록 할 수 있습니다. 버전 4.72 이하에서는 동등한 스타일 플래그인 TBSTYLE_DROPDOWN을 사용합니다.
도구 모음에 TBSTYLE_EX_DRAWDDARROWS 확장 스타일이 있는 경우 드롭다운 단추 오른쪽에 별도의 섹션에 드롭다운 화살표가 표시됩니다. 화살표를 클릭하면 TBN_DROPDOWN 알림 코드가 전송됩니다. 연결된 단추를 클릭하면 WM_COMMAND 메시지가 전송됩니다.
BTNS_GROUP
 버전 5.80. BTNS_CHECK와 결합하면 그룹의 다른 단추를 누를 때까지 누른 상태를 유지하는 단추를 만듭니다. 버전 4.72 이하에서는 동등한 스타일 플래그인 TBSTYLE_GROUP을 사용합니다.
BTNS_NOPREFIX
 버전 5.80. 단추 텍스트에 연관된 가속기 접두사가 없도록 지정합니다. 버전 4.72 이하에서는 동등한 스타일 플래그인 TBSTYLE_NOPREFIX를 사용합니다.
BTNS_SEP
 버전 5.80. 단추 그룹 사이에 작은 간격을 제공하는 구분 기호를 만듭니다. 이 스타일이 있는 단추는 사용자 입력을 받지 않습니다. 버전 4.72 및 이전 버전에는 동등한 스타일 플래그인 TBSTYLE_SEP를 사용합니다.
BTNS_SHOWTEXT
 버전 5.81. 단추 텍스트가 표시되도록 지정합니다. 모든 단추에 텍스트가 있을 수 있지만 BTNS_SHOWTEXT 단추 스타일이 있는 단추만 텍스트를 표시합니다. 이 단추 스타일은 TBSTYLE_LIST 스타일 및 TBSTYLE_EX_MIXEDBUTTONS 확장 스타일과 함께 사용해야 합니다. BTNS_SHOWTEXT 스타일이 없는 단추에 텍스트를 설정하면 커서가 단추 위에 있을 때 도구 모음 컨트롤이 자동으로 도구 설명으로 표시합니다. 이 기능을 사용하면 애플리케이션이 도구 모음에 대한 TBN_GETINFOTIP 또는 TTN_GETDISPINFO 알림 코드를 처리하지 않도록 할 수 있습니다.
BTNS_WHOLEDROPDOWN
 버전 5.80. 단추에 드롭다운 화살표가 있지만 별도의 섹션이 아님을 지정합니다. 이 스타일의 단추는 TBSTYLE_EX_DRAWDDARROWS 확장 스타일 설정 여부와 관계없이 동일하게 작동합니다.
TBSTYLE_AUTOSIZE
 BTNS_AUTOSIZE와 동등합니다. 버전 4.72 이하에서는 TBSTYLE_AUTOSIZE를 사용합니다.
TBSTYLE_BUTTON
 BTNS_BUTTON과 동등합니다. 버전 4.72 이하에서는 TBSTYLE_BUTTON을 사용합니다.
TBSTYLE_CHECK
 BTNS_CHECK와 동등합니다. 버전 4.72 이하에서는 TBSTYLE_CHECK를 사용합니다.
TBSTYLE_CHECKGROUP
 BTNS_CHECKGROUP과 동등합니다. 버전 4.72 이하에서는 TBSTYLE_CHECKGROUP을 사용합니다.
TBSTYLE_DROPDOWN
 BTNS_DROPDOWN과 동등합니다. 버전 4.72 이하에서는 TBSTYLE_DROPDOWN을 사용합니다.
TBSTYLE_GROUP
 BTNS_GROUP과 동등합니다. 버전 4.72 이하에서는 TBSTYLE_GROUP을 사용합니다.
TBSTYLE_NOPREFIX
 BTNS_NOPREFIX와 동등합니다. 버전 4.72 이하에서는 TBSTYLE_NOPREFIX를 사용합니다.
TBSTYLE_SEP
 BTNS_SEP와 동등합니다. 버전 4.72 이하에서는 TBSTYLE_SEP를 사용합니다.

요구 사항

요구 사항 값
헤더
CommCtrl.h