CToolBarCtrl 수업

Windows의 도구 모음 공용 컨트롤의 기능을 제공합니다.

구문

class CToolBarCtrl : public CWnd

멤버

공용 생성자

속성	설명
CToolBarCtrl::CToolBarCtrl	CToolBarCtrl 개체를 생성합니다.

공용 메서드

이름	설명
CToolBarCtrl::AddBitmap	도구 모음 컨트롤에 사용할 수 있는 단추 이미지 목록에 하나 이상의 비트맵 단추 이미지를 추가합니다.
CToolBarCtrl::AddButtons	도구 모음 컨트롤에 하나 이상의 단추를 추가합니다.
CToolBarCtrl::AddString	리소스 ID로 전달된 새 문자열을 도구 모음의 내부 문자열 목록에 추가합니다.
CToolBarCtrl::AddStrings	구분된 문자열 버 NULL퍼에 대한 포인터로 전달되는 새 문자열 또는 문자열을 도구 모음의 내부 문자열 목록에 추가합니다.
CToolBarCtrl::AutoSize	도구 모음 컨트롤의 크기를 조정합니다.
CToolBarCtrl::ChangeBitmap	현재 도구 모음 컨트롤의 단추에 대한 비트맵을 변경합니다.
CToolBarCtrl::CheckButton	도구 모음 컨트롤에서 지정된 단추를 확인하거나 지웁니다.
CToolBarCtrl::CommandToIndex	지정된 명령 식별자와 연결된 단추에 대해 0부터 시작하는 인덱스를 검색합니다.
CToolBarCtrl::Create	도구 모음 컨트롤을 만들어 개체에 CToolBarCtrl 연결합니다.
CToolBarCtrl::CreateEx	지정된 Windows 확장 스타일을 사용하여 도구 모음 컨트롤을 만들고 개체에 CToolBarCtrl 연결합니다.
CToolBarCtrl::Customize	도구 모음 사용자 지정 대화 상자를 표시합니다.
CToolBarCtrl::DeleteButton	도구 모음 컨트롤에서 단추를 삭제합니다.
CToolBarCtrl::EnableButton	도구 모음 컨트롤에서 지정된 단추를 사용하거나 사용하지 않도록 설정합니다.
CToolBarCtrl::GetAnchorHighlight	도구 모음의 앵커 강조 표시 설정을 검색합니다.
CToolBarCtrl::GetBitmap	도구 모음의 단추와 연결된 비트맵의 인덱스를 검색합니다.
CToolBarCtrl::GetBitmapFlags	도구 모음의 비트맵과 연결된 플래그를 가져옵니다.
CToolBarCtrl::GetButton	도구 모음 컨트롤에서 지정된 단추에 대한 정보를 검색합니다.
CToolBarCtrl::GetButtonCount	현재 도구 모음 컨트롤에 있는 단추 수를 검색합니다.
CToolBarCtrl::GetButtonInfo	도구 모음에서 단추에 대한 정보를 검색합니다.
CToolBarCtrl::GetButtonSize	도구 모음 단추의 현재 너비와 높이를 픽셀 단위로 검색합니다.
CToolBarCtrl::GetColorScheme	현재 도구 모음 컨트롤의 색 구성표를 검색합니다.
CToolBarCtrl::GetDisabledImageList	도구 모음 컨트롤이 비활성화된 단추를 표시하는 데 사용하는 이미지 목록을 검색합니다.
CToolBarCtrl::GetDropTarget	도구 모음 컨트롤의 IDropTarget 인터페이스를 검색합니다.
CToolBarCtrl::GetExtendedStyle	도구 모음 컨트롤의 확장 스타일을 검색합니다.
CToolBarCtrl::GetHotImageList	도구 모음 컨트롤이 "핫" 단추를 표시하는 데 사용하는 이미지 목록을 검색합니다. 마우스 포인터가 위에 있으면 핫 단추가 강조 표시됩니다.
CToolBarCtrl::GetHotItem	도구 모음에서 핫 항목의 인덱스를 검색합니다.
CToolBarCtrl::GetImageList	도구 모음 컨트롤이 단추를 기본 상태로 표시하는 데 사용하는 이미지 목록을 검색합니다.
CToolBarCtrl::GetInsertMark	도구 모음의 현재 삽입 표시를 검색합니다.
CToolBarCtrl::GetInsertMarkColor	도구 모음의 삽입 표시를 그리는 데 사용되는 색을 검색합니다.
CToolBarCtrl::GetItemRect	도구 모음 컨트롤에서 단추의 경계 사각형을 검색합니다.
CToolBarCtrl::GetMaxSize	도구 모음에 표시되는 모든 단추 및 구분 기호의 총 크기를 검색합니다.
CToolBarCtrl::GetMaxTextRows	도구 모음 단추에 표시되는 최대 텍스트 행 수를 검색합니다.
CToolBarCtrl::GetMetrics	도구 모음 컨트롤의 메트릭을 검색합니다.
CToolBarCtrl::GetPadding	현재 도구 모음 컨트롤의 가로 및 세로 안쪽 여백을 검색합니다.
CToolBarCtrl::GetPressedImageList	현재 도구 모음 컨트롤이 누름 상태의 단추를 나타내는 데 사용하는 이미지 목록을 검색합니다.
CToolBarCtrl::GetRect	지정된 도구 모음 단추의 경계 사각형을 검색합니다.
CToolBarCtrl::GetRows	도구 모음에 현재 표시되는 단추의 행 수를 검색합니다.
CToolBarCtrl::GetState	도구 모음 컨트롤에서 지정된 단추의 상태(예: 사용 여부, 누름 또는 선택됨)에 대한 정보를 검색합니다.
CToolBarCtrl::GetString	도구 모음 문자열을 검색합니다.
CToolBarCtrl::GetStyle	도구 모음 컨트롤의 현재 사용 중인 스타일을 검색합니다.
CToolBarCtrl::GetToolTips	도구 모음 컨트롤과 연결된 도구 설명 컨트롤의 핸들(있는 경우)을 검색합니다.
CToolBarCtrl::HideButton	도구 모음 컨트롤에서 지정된 단추를 숨기거나 표시합니다.
CToolBarCtrl::HitTest	도구 모음 컨트롤에서 점이 있는 위치를 결정합니다.
CToolBarCtrl::Indeterminate	도구 모음 컨트롤에서 지정된 단추의 확정되지 않은(회색) 상태를 설정하거나 지웁니다.
CToolBarCtrl::InsertButton	도구 모음 컨트롤에 단추를 삽입합니다.
CToolBarCtrl::InsertMarkHitTest	도구 모음의 한 지점에 대한 삽입 표시 정보를 검색합니다.
CToolBarCtrl::IsButtonChecked	도구 모음 컨트롤의 지정된 단추를 선택했는지 여부를 알려줍니다.
CToolBarCtrl::IsButtonEnabled	도구 모음 컨트롤에서 지정된 단추를 사용할 수 있는지 여부를 알려줍니다.
CToolBarCtrl::IsButtonHidden	도구 모음 컨트롤의 지정된 단추가 숨겨져 있는지 여부를 나타냅니다.
CToolBarCtrl::IsButtonHighlighted	도구 모음 단추의 강조 표시 상태를 확인합니다.
CToolBarCtrl::IsButtonIndeterminate	도구 모음 컨트롤에서 지정된 단추의 상태가 확정되지 않았는지(회색)인지 여부를 나타냅니다.
CToolBarCtrl::IsButtonPressed	도구 모음 컨트롤의 지정된 단추를 누를지 여부를 알려줍니다.
CToolBarCtrl::LoadImages	비트맵을 도구 모음 컨트롤의 이미지 목록에 로드합니다.
CToolBarCtrl::MapAccelerator	액셀러레이터 문자를 도구 모음 단추에 매핑합니다.
CToolBarCtrl::MarkButton	도구 모음 컨트롤에서 지정된 단추의 강조 표시 상태를 설정합니다.
CToolBarCtrl::MoveButton	한 인덱스에서 다른 인덱스로 단추를 이동합니다.
CToolBarCtrl::PressButton	도구 모음 컨트롤에서 지정된 단추를 누르거나 놓습니다.
CToolBarCtrl::ReplaceBitmap	현재 도구 모음 컨트롤의 기존 비트맵을 새 비트맵으로 바꿉니다.
CToolBarCtrl::RestoreState	도구 모음 컨트롤의 상태를 복원합니다.
CToolBarCtrl::SaveState	도구 모음 컨트롤의 상태를 저장합니다.
CToolBarCtrl::SetAnchorHighlight	도구 모음의 앵커 강조 표시 설정을 구성합니다.
CToolBarCtrl::SetBitmapSize	도구 모음 컨트롤에 추가할 비트맵 이미지의 크기를 설정합니다.
CToolBarCtrl::SetButtonInfo	도구 모음의 기존 단추에 대한 정보를 설정합니다.
CToolBarCtrl::SetButtonSize	도구 모음 컨트롤에 추가할 단추의 크기를 설정합니다.
CToolBarCtrl::SetButtonStructSize	구조체의 크기를 지정합니다 TBBUTTON .
CToolBarCtrl::SetButtonWidth	도구 모음 컨트롤의 최소 및 최대 단추 너비를 설정합니다.
CToolBarCtrl::SetCmdID	지정한 단추를 누를 때 소유자 창으로 보낼 명령 식별자를 설정합니다.
CToolBarCtrl::SetColorScheme	현재 도구 모음 컨트롤의 색 구성표를 설정합니다.
CToolBarCtrl::SetDisabledImageList	도구 모음 컨트롤이 비활성화된 단추를 표시하는 데 사용할 이미지 목록을 설정합니다.
CToolBarCtrl::SetDrawTextFlags	지정된 사각형에 텍스트를 그리는 데 사용되는 Win32 함수 DrawText의 플래그를 설정하며 플래그 설정 방식에 따라 서식이 지정됩니다.
CToolBarCtrl::SetExtendedStyle	도구 모음 컨트롤의 확장 스타일을 설정합니다.
CToolBarCtrl::SetHotImageList	도구 모음 컨트롤이 "핫" 단추를 표시하는 데 사용할 이미지 목록을 설정합니다.
CToolBarCtrl::SetHotItem	도구 모음에서 핫 항목을 설정합니다.
CToolBarCtrl::SetImageList	도구 모음에서 기본 상태의 단추를 표시하는 데 사용할 이미지 목록을 설정합니다.
CToolBarCtrl::SetIndent	도구 모음 컨트롤의 첫 번째 단추에 대한 들여쓰기를 설정합니다.
CToolBarCtrl::SetInsertMark	도구 모음의 현재 삽입 표시를 설정합니다.
CToolBarCtrl::SetInsertMarkColor	도구 모음의 삽입 표시를 그리는 데 사용되는 색을 설정합니다.
CToolBarCtrl::SetMaxTextRows	도구 모음 단추에 표시되는 최대 텍스트 행 수를 설정합니다.
CToolBarCtrl::SetMetrics	도구 모음 컨트롤의 메트릭을 설정합니다.
CToolBarCtrl::SetOwner	도구 모음 컨트롤에서 알림 메시지를 받을 창을 설정합니다.
CToolBarCtrl::SetPadding	현재 도구 모음 컨트롤의 가로 및 세로 안쪽 여백을 설정합니다.
CToolBarCtrl::SetPressedImageList	현재 도구 모음 컨트롤이 누른 상태의 단추를 나타내는 데 사용하는 이미지 목록을 설정합니다.
CToolBarCtrl::SetRows	도구 모음에 표시되는 단추의 행 수를 설정합니다.
CToolBarCtrl::SetState	도구 모음 컨트롤에서 지정된 단추의 상태를 설정합니다.
CToolBarCtrl::SetStyle	도구 모음 컨트롤의 스타일을 설정합니다.
CToolBarCtrl::SetToolTips	도구 설명 컨트롤을 도구 모음 컨트롤과 연결합니다.
CToolBarCtrl::SetWindowTheme	도구 모음 컨트롤의 시각적 스타일을 설정합니다.

설명

이 컨트롤(따라서 CToolBarCtrl 클래스)은 Windows 95/98 및 Windows NT 버전 3.51 이상에서 실행되는 프로그램에서만 사용할 수 있습니다.

Windows 도구 모음 공통 컨트롤은 하나 이상의 단추를 포함하는 사각형 자식 창입니다. 이러한 단추는 비트맵 이미지, 문자열 또는 둘 다를 표시할 수 있습니다. 사용자가 단추를 선택하면 도구 모음의 소유자 창에 명령 메시지를 보냅니다. 일반적으로 도구 모음의 단추는 애플리케이션 메뉴의 항목에 해당합니다. 사용자가 애플리케이션의 명령에 액세스할 수 있는 보다 직접적인 방법을 제공합니다.

CToolBarCtrl 개체에는 단추 이미지 비트맵 또는 이미지 목록 목록, 단추 레이블 문자열 목록, 단추의 TBBUTTON 위치, 스타일, 상태 및 명령 ID와 이미지 및/또는 문자열을 연결하는 구조 목록과 같은 몇 가지 중요한 내부 데이터 구조가 포함됩니다. 이러한 데이터 구조의 각 요소는 0부터 시작하는 인덱스로 참조됩니다. 개체를 CToolBarCtrl 사용하려면 먼저 이러한 데이터 구조를 설정해야 합니다. 문자열 목록은 단추 레이블에만 사용할 수 있습니다. 도구 모음에서 문자열을 검색할 수 없습니다.

개체를 CToolBarCtrl 사용하려면 일반적으로 다음 단계를 수행합니다.

1. CToolBarCtrl 개체를 생성합니다.

2. 호출 Create 하여 Windows 도구 모음 일반 컨트롤을 만들고 개체에 CToolBarCtrl 연결합니다. 투명한 도구 모음이나 TBSTYLE_DROPDOWN 드롭다운 스타일 단추를 지원하는 도구 모음과 같은 TBSTYLE_TRANSPARENT 스타일을 사용하여 도구 모음의 스타일을 나타냅니다.

3. 도구 모음에 단추를 표시할 방법을 식별합니다.

   • 단추에 비트맵 이미지를 사용하려면 단추를 호출 AddBitmap하여 도구 모음에 단추 비트맵을 추가합니다.

   • 단추에 대해 이미지 목록에서 표시된 이미지를 사용하려면 이미지 목록을 호출SetImageListSetHotImageList하여 지정하거나 SetDisabledImageList.

   • 단추에 문자열 레이블을 사용하려면 호출 AddString 및/또는 AddStrings을 사용하여 도구 모음에 문자열을 추가합니다.

4. 를 호출 AddButtons하여 도구 모음에 단추 구조를 추가합니다.

5. 소유자 창에 없는 CFrameWnd도구 모음 단추에 대한 도구 팁을 원하는 경우 도구 설명 알림 처리에 설명된 대로 도구 모음의 소유자 창에서 메시지를 처리 TTN_NEEDTEXT 해야 합니다. 도구 모음의 부모 창이 파생된 CFrameWnd경우 도구 팁은 기본 처리기를 제공하므로 추가 작업 CFrameWnd 없이 표시됩니다.

6. 사용자가 도구 모음을 사용자 지정할 수 있도록 하려면 사용자 지정 알림 처리에 설명된 대로 소유자 창에서 사용자 지정 알림 메시지를 처리합니다.

레지스트리에 도구 모음 컨트롤의 현재 상태를 저장하고 RestoreState 이전에 레지스트리에 저장된 정보에 따라 상태를 복원하는 데 사용할 SaveState 수 있습니다. 애플리케이션의 사용 간에 도구 모음 상태를 저장하는 것 외에도 애플리케이션은 일반적으로 사용자가 나중에 도구 모음을 원래 상태로 복원하려는 경우 도구 모음 사용자 지정을 시작하기 전에 상태를 저장합니다.

Internet Explorer 버전 4.0 이상 지원

Internet Explorer 버전 4.0 이상에서 도입된 기능을 지원하기 위해 MFC는 도구 모음 컨트롤에 대한 이미지 목록 지원 및 투명하고 평평한 스타일을 제공합니다.

투명한 도구 모음을 사용하면 도구 모음 아래의 클라이언트를 통해 표시할 수 있습니다. 투명한 도구 모음을 만들려면 스타일과 TBSTYLE_TRANSPARENT 스타일을 모두 TBSTYLE_FLAT 사용합니다. 투명 도구 모음 기능 핫 추적; 즉, 마우스 포인터가 도구 모음의 핫 단추 위로 이동하면 단추의 모양이 변경됩니다. 스타일만 TBSTYLE_FLAT 사용하여 만든 도구 모음에는 투명하지 않은 단추가 포함됩니다.

이미지 목록 지원을 사용하면 기본 동작, 핫 이미지 및 비활성화된 이미지에 대한 더 큰 유연성을 제어할 수 있습니다. GetHotImageListGetDisabledImageList 투명 도구 모음을 사용하여 GetImageList해당 상태에 따라 이미지를 조작합니다.

사용 CToolBarCtrl방법에 대한 자세한 내용은 컨트롤 및 사용을 CToolBarCtrl참조하세요.

상속 계층 구조

CObject

CCmdTarget

CWnd

CToolBarCtrl

요구 사항

머리글: afxcmn.h

CToolBarCtrl::AddBitmap

도구 모음 컨트롤에 저장된 단추 이미지 목록에 하나 이상의 단추 이미지를 추가합니다.

int AddBitmap(
    int nNumButtons,
    UINT nBitmapID);

int AddBitmap(
    int nNumButtons,
    CBitmap* pBitmap);

매개 변수

nNumButtons
비트맵의 단추 이미지 수입니다.

nBitmapID
추가할 단추 이미지 또는 이미지가 포함된 비트맵의 리소스 식별자입니다.

pBitmap
CBitmap 추가할 단추 이미지 또는 이미지가 들어 있는 개체에 대한 포인터입니다.

Return Value

성공하면 첫 번째 새 이미지의 인덱스(0부터 시작)입니다. 그렇지 않으면 - 1.

설명

도구 모음에 비트맵을 추가하기 전에 Windows API CreateMappedBitmap 를 사용하여 색을 매핑할 수 있습니다. 개체에 포인터를 CBitMap 전달하는 경우 도구 모음이 제거될 때까지 비트맵이 제거되지 않도록 해야 합니다.

CToolBarCtrl::AddButtons

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

BOOL AddButtons(
    int nNumButtons,
    LPTBBUTTON lpButtons);

매개 변수

nNumButtons
추가할 단추 수입니다.

lpButtons
추가할 단추에 대한 정보를 포함하는 구조체 배열 TBBUTTON 의 주소입니다. 배열에 지정된 nNumButtons단추와 동일한 수의 요소가 있어야 합니다.

Return Value

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

포인터는 lpButtons 구조체 배열 TBBUTTON 을 가리킵니다. 각 TBBUTTON 구조는 추가되는 단추를 단추의 스타일, 이미지 및/또는 문자열, 명령 ID, 상태 및 사용자 정의 데이터와 연결합니다.

typedef struct _TBBUTTON {
    int iBitmap;    // zero-based index of button image
    int idCommand;  // command to be sent when button pressed
    BYTE fsState;   // button state--see below
    BYTE fsStyle;   // button style--see below
    DWORD dwData;   // application-defined value
    int iString;    // zero-based index of button label string
} TBBUTTON;

멤버는 다음과 같습니다.

• iBitmap

  단추 이미지의 인덱스(0부터 시작하는 인덱스) - 이 단추에 대한 이미지가 없으면 -1입니다.

• idCommand

  단추와 연결된 명령 식별자입니다. 이 식별자는 단추를 선택할 때 메시지로 WM_COMMAND 전송됩니다. 멤버에 fsStyle 값이 TBSTYLE_SEP 있는 경우 이 멤버는 0이어야 합니다.

• fsState

  단추 상태 플래그입니다. 아래에 나열된 값의 조합일 수 있습니다.

  • TBSTATE_CHECKED 단추에 스타일이 TBSTYLE_CHECKED 있으며 누르고 있습니다.

  • TBSTATE_ENABLED 단추는 사용자 입력을 허용합니다. 이 상태가 없는 단추는 사용자 입력을 허용하지 않으며 회색으로 표시됩니다.

  • TBSTATE_HIDDEN 단추가 표시되지 않으며 사용자 입력을 받을 수 없습니다.

  • TBSTATE_INDETERMINATE 단추가 회색으로 표시됩니다.

  • TBSTATE_PRESSED 단추를 누르고 있습니다.

  • TBSTATE_WRAP 줄 바꿈이 단추를 따릅니다. 단추의 상태도 있어야 TBSTATE_ENABLED 합니다.

• fsStyle

  단추 스타일입니다. 아래에 나열된 값의 조합일 수 있습니다.

  • TBSTYLE_BUTTON 표준 푸시 단추를 만듭니다.

  • TBSTYLE_CHECK 사용자가 클릭할 때마다 누른 상태와 눌지 않은 상태 간에 전환되는 단추를 만듭니다. 단추가 눌린 상태일 때 단추의 배경색이 다릅니다.

  • TBSTYLE_CHECKGROUP 그룹의 다른 단추를 누를 때까지 계속 누르는 확인 단추를 만듭니다.

  • TBSTYLE_GROUP 그룹의 다른 단추를 누를 때까지 계속 누르는 단추를 만듭니다.

  • TBSTYLE_SEP 단추 그룹 간에 작은 간격을 제공하는 구분 기호를 만듭니다. 이 스타일이 있는 단추는 사용자 입력을 받지 않습니다.

• dwData

  사용자 정의 데이터입니다.

• iString

  단추의 레이블로 사용할 문자열의 인덱스(0부터 시작하는 인덱스)입니다. 이 단추에 대한 문자열이 없으면 -1입니다.

제공된 인덱스가 이전에 , 및/또는 를 사용하여 AddBitmapAddString도구 모음 컨트롤의 목록에 추가되어야 하는 이미지 및/또는 AddStrings문자열입니다.

CToolBarCtrl::AddString

리소스 ID로 전달된 새 문자열을 도구 모음의 내부 문자열 목록에 추가합니다.

int AddString(UINT nStringID);

매개 변수

nStringID
도구 모음 컨트롤의 문자열 목록에 추가할 문자열 리소스의 리소스 식별자입니다.

Return Value

성공하면 추가된 첫 번째 새 문자열의 인덱스(0부터 시작)입니다. 그렇지 않으면 -1입니다.

CToolBarCtrl::AddStrings

도구 모음 컨트롤에 사용할 수 있는 문자열 목록에 새 문자열 또는 문자열을 추가합니다.

int AddStrings(LPCTSTR lpszStrings);

매개 변수

lpszStrings
도구 모음의 문자열 목록에 추가할 하나 이상의 NULL종결 문자열이 포함된 버퍼의 주소입니다. 마지막 문자열은 두 NULL 문자로 종료해야 합니다.

Return Value

성공하면 추가된 첫 번째 새 문자열의 인덱스(0부터 시작)입니다. 그렇지 않으면 -1입니다.

설명

버퍼의 문자열은 문자로 NULL 구분해야 합니다. 마지막 문자열에 두 개의 NULL 종결자가 있는지 확인해야 합니다. 상수 문자열의 서식을 올바르게 지정하려면 다음과 같이 작성할 수 있습니다.

// one null added automatically
lpszStrings = _T("Only one string to add\0");

또는:

// adds three strings with one call
lpszStrings = _T("String 1\0String 2\0String 3\0");

에 둘 이상의 NULL 문자를 사용할 수 없으므로 개체를 이 함수에 CString전달 CString 해서는 안 됩니다.

CToolBarCtrl::AutoSize

전체 도구 모음 컨트롤의 크기를 조정합니다.

void AutoSize();

설명

부모 창의 크기가 변경되거나 도구 모음의 크기가 변경되는 경우(예: 단추 또는 비트맵 크기를 설정하거나 문자열을 추가할 때) 이 함수를 호출해야 합니다.

CToolBarCtrl::ChangeBitmap

현재 도구 모음 컨트롤의 단추에 대한 비트맵을 변경합니다.

BOOL ChangeBitmap(
    int idButton,
    int iBitmap);

매개 변수

idButton
[in] 새 비트맵을 받을 단추의 명령 식별자입니다.

iBitmap
[in] 현재 도구 모음 컨트롤의 이미지 목록에 있는 이미지의 인덱스(0부터 시작하는 인덱스)입니다.

Return Value

TRUE이 메서드가 성공하면 이고, 그렇지 않으면 . FALSE

설명

이 메서드가 성공하면 시스템에서 지정된 단추에 지정된 이미지를 표시합니다.

이 메서드는 TB_CHANGEBITMAP Windows SDK에 설명된 메시지를 보냅니다.

예시

다음 코드 예제에서는 파일 저장 단추의 비트맵을 정보 단추의 비트맵으로 변경합니다.

{
   // Change the bitmap for the File Save button, whose
   // command ID is ID_FILE_SAVE, to the bitmap for the
   // About button, whose index is 7.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   BOOL bRet = m_toolBarCtrl.ChangeBitmap(ID_FILE_SAVE, 7);
}

CToolBarCtrl::CheckButton

도구 모음 컨트롤에서 지정된 단추를 확인하거나 지웁니다.

BOOL CheckButton(
    int nID,
    BOOL bCheck = TRUE);

매개 변수

nID
확인하거나 지울 단추의 명령 식별자입니다.

bCheck
TRUE 단추를 확인하려면 단추를 FALSE 지웁니다.

Return Value

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

단추를 선택하면 단추가 누른 것으로 보입니다. 단추 상태를 둘 이상 변경하려면 대신 호출 SetState 하는 것이 좋습니다.

CToolBarCtrl::CommandToIndex

지정된 명령 식별자와 연결된 단추에 대한 인덱스(0부터 시작)를 검색합니다.

UINT CommandToIndex(UINT nID) const;

매개 변수

nID
찾려는 단추 인덱스가 있는 명령 ID입니다.

Return Value

명령 ID와 연결된 단추에 대한 인덱스(0부터 시작하는 인덱스)입니다.

설명

CToolBarCtrl::Create

도구 모음 컨트롤을 만들어 개체에 CToolBarCtrl 연결합니다.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

매개 변수

dwStyle
도구 모음 컨트롤의 스타일을 지정합니다. 도구 모음에는 항상 스타일이 WS_CHILD 있어야 합니다. 또한 주의에 설명된 대로 도구 모음 스타일과 창 스타일의 조합을 지정할 수 있습니다.

rect
필요에 따라 도구 모음 컨트롤의 크기와 위치를 지정합니다. 개체 또는 RECT 구조체 CRect 일 수 있습니다.

pParentWnd
도구 모음 컨트롤의 부모 창을 지정합니다. 해서는 안 됩니다 NULL.

nID
도구 모음 컨트롤의 ID를 지정합니다.

Return Value

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

두 단계로 구성 CToolBarCtrl 합니다. 먼저 생성자를 호출한 다음, 도구 모음 컨트롤을 만들어 개체에 CToolBarCtrl 연결하는 호출Create합니다. 도구 모음 컨트롤에 다음 창 스타일을 적용합니다.

• WS_CHILD 늘

• WS_VISIBLE 보통

• WS_DISABLED 드물게

창 스타일에 대한 설명은 Windows SDK를 참조 CreateWindow 하세요.

필요에 따라 Windows SDK에 설명된 대로 공통 컨트롤 스타일의 조합을 적용합니다.

컨트롤 또는 단추 자체에 도구 모음 스타일의 조합을 적용합니다. 스타일은 Windows SDK의 도구 모음 컨트롤 및 단추 스타일 항목에 설명되어 있습니다.

확장 도구 모음 스타일을 사용하려면 호출한 후 호출 SetExtendedStyle Create합니다. 확장 창 스타일을 사용하여 도구 모음을 만들려면 대신 호출 CToolBarCtrl::CreateEx 합니다 Create.

도구 모음 컨트롤은 도구 모음 창의 크기와 위치를 자동으로 설정합니다. 높이는 도구 모음의 단추 높이를 기준으로 합니다. 너비는 부모 창의 클라이언트 영역 너비와 동일합니다. 및 CCS_BOTTOM 스타일은 CCS_TOP 도구 모음이 클라이언트 영역의 위쪽 또는 아래쪽을 따라 배치되는지 여부를 결정합니다. 기본적으로 도구 모음에는 스타일이 있습니다 CCS_TOP .

CToolBarCtrl::CreateEx

컨트롤(자식 창)을 만들어 개체와 연결 CToolBarCtrl 합니다.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

매개 변수

dwExStyle
만들 컨트롤의 확장 스타일을 지정합니다. 확장된 Windows 스타일 목록은 Windows SDK의 매개 변수 CreateWindowEx 를 참조 dwExStyle 하세요.

dwStyle
도구 모음 컨트롤의 스타일을 지정합니다. 도구 모음에는 항상 스타일이 WS_CHILD 있어야 합니다. 또한 주의 섹션에 설명된 대로 도구 모음 스타일과 창 스타일의 조합을 지정할 수 있습니다.Create

rect
생성할 RECT 창의 크기와 위치를 설명하는 구조체에 대한 참조로, 클라이언트 좌표로 pParentWnd표시됩니다.

pParentWnd
컨트롤의 부모 창에 대한 포인터입니다.

nID
컨트롤의 자식 창 ID입니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

설명

Windows 확장 스타일 서문WS_EX_으로 지정된 확장 Windows 스타일을 적용하는 대신 Create 사용합니다CreateEx. CreateEx 에서 지정한 확장된 Windows 스타일을 사용하여 컨트롤을 dwExStyle만듭니다. 를 사용하여 SetExtendedStyle컨트롤에 특정한 확장 스타일을 설정합니다. 예를 들어 이러한 스타일을 설정하는 데는 사용 CreateEx 하지만 다음과 같은 WS_EX_CONTEXTHELPTBSTYLE_EX_DRAWDDARROWS스타일을 설정하는 데 사용합니다SetExtendedStyle. 자세한 내용은 Windows SDK의 도구 모음 확장 스타일에 설명된 스타일을 참조하세요.

CToolBarCtrl::CToolBarCtrl

CToolBarCtrl 개체를 생성합니다.

CToolBarCtrl();

설명

도구 모음을 사용할 수 있도록 호출 Create 해야 합니다.

CToolBarCtrl::Customize

도구 모음 사용자 지정 대화 상자를 표시합니다.

void Customize();

설명

이 대화 상자를 사용하면 사용자가 단추를 추가하고 삭제하여 도구 모음을 사용자 지정할 수 있습니다. 사용자 지정을 지원하려면 사용자 지정 알림 처리에 설명된 대로 도구 모음의 부모 창에서 사용자 지정 알림 메시지를 처리해야 합니다. 에 설명CToolBarCtrl::Create된 대로 도구 모음도 스타일을 사용하여 CCS_ADJUSTABLE 만들어야 합니다.

CToolBarCtrl::DeleteButton

도구 모음 컨트롤에서 단추를 삭제합니다.

BOOL DeleteButton(int nIndex);

매개 변수

nIndex
삭제할 단추의 0부터 시작하는 인덱스입니다.

Return Value

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

CToolBarCtrl::EnableButton

도구 모음 컨트롤에서 지정된 단추를 사용하거나 사용하지 않도록 설정합니다.

BOOL EnableButton(
    int nID,
    BOOL bEnable = TRUE);

매개 변수

nID
사용하거나 사용하지 않도록 설정할 단추의 명령 식별자입니다.

bEnable
TRUE 단추를 사용하도록 설정하려면 다음을 실행합니다. FALSE 단추를 사용하지 않도록 설정합니다.

Return Value

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

단추를 사용하도록 설정하면 단추를 누르고 확인할 수 있습니다. 단추 상태를 둘 이상 변경하려면 대신 호출 SetState 하는 것이 좋습니다.

CToolBarCtrl::GetAnchorHighlight

도구 모음의 앵커 강조 표시 설정을 검색합니다.

BOOL GetAnchorHighlight() const;

Return Value

0이 아닌 경우 앵커 강조 표시가 사용됩니다. 0이면 앵커 강조 표시를 사용할 수 없습니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_GETANCHORHIGHLIGHT의 동작을 구현합니다.

CToolBarCtrl::GetBitmap

도구 모음의 단추와 연결된 비트맵의 인덱스를 검색합니다.

int GetBitmap(int nID) const;

매개 변수

nID
비트맵 인덱스를 검색할 단추의 명령 식별자입니다.

Return Value

성공하면 비트맵의 인덱스를 반환하고 그렇지 않으면 0을 반환합니다.

설명

Windows SDK의 TB_GETBITMAP 기능을 구현합니다.

CToolBarCtrl::GetBitmapFlags

도구 모음에서 비트맵 플래그를 검색합니다.

UINT GetBitmapFlags() const;

Return Value

디스플레이가 TBBF_LARGE 큰 도구 모음 비트맵을 지원할 수 있는 경우 플래그가 설정된 A UINT 를 선택 취소합니다.

설명

도구 모음을 만든 후 도구 모음에 비트맵을 추가하기 전에 호출해야 합니다. 반환 값은 디스플레이에서 큰 비트맵을 지원하는지 여부를 나타냅니다. 디스플레이에서 큰 비트맵을 지원하고 해당 비트맵을 사용하도록 선택하는 경우 호출하고 SetButtonSize 다음을 사용하여 AddBitmap큰 비트맵을 추가하기 전에 호출 SetBitmapSize 합니다.

CToolBarCtrl::GetButton

도구 모음 컨트롤에서 지정된 단추에 대한 정보를 검색합니다.

BOOL GetButton(
    int nIndex,
    LPTBBUTTON lpButton) const;

매개 변수

nIndex
정보를 검색할 단추의 인덱스(0부터 시작)입니다.

lpButton
TBBUTTON 단추 정보의 복사본을 받을 구조체의 주소입니다. 구조에 대한 자세한 내용은 참조 CToolBarCtrl::AddButtons 하세요 TBBUTTON .

Return Value

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

CToolBarCtrl::GetButtonCount

현재 도구 모음 컨트롤에 있는 단추 수를 검색합니다.

int GetButtonCount() const;

Return Value

단추의 수입니다.

CToolBarCtrl::GetButtonInfo

도구 모음에서 단추에 대한 정보를 검색합니다.

int GetButtonInfo(
    int nID,
    TBBUTTONINFO* ptbbi) const;

매개 변수

nID
단추 식별자입니다.

ptbbi
단추 정보를 받는 구조체에 대한 포인터 TBBUTTONINFO 입니다.

Return Value

성공하면 단추의 인덱스(0부터 시작하는 인덱스)입니다. 그렇지 않으면 -1입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_GETBUTTONINFO의 동작을 구현합니다.

CToolBarCtrl::GetButtonSize

도구 모음 단추의 크기를 가져옵니다.

DWORD GetButtonSize() const;

Return Value

DWORD 각각에 있는 너비 및 높이 값을 포함하는 값 LOWORD HIWORD입니다.

CToolBarCtrl::GetButtonText

현재 도구 모음 컨트롤에서 지정된 단추의 표시 텍스트를 검색합니다.

CString GetButtonText(int idButton) const;

매개 변수

idButton
[in] 표시 텍스트가 검색되는 단추의 식별자입니다.

Return Value

CString 지정한 단추의 표시 텍스트가 들어 있는 A입니다.

설명

이 메서드는 TB_GETBUTTONTEXT Windows SDK에 설명된 메시지를 보냅니다.

CToolBarCtrl::GetColorScheme

현재 도구 모음 컨트롤의 색 구성표를 검색합니다.

BOOL GetColorScheme(COLORSCHEME* lpColorScheme) const;

매개 변수

lpColorScheme
[out] COLORSCHEME 색 구성표 정보를 받는 구조체에 대한 포인터입니다. 이 메서드가 반환되면 구조체는 도구 모음 컨트롤의 강조 색과 그림자 색을 설명합니다.

Return Value

TRUE이 메서드가 성공하면 이고, 그렇지 않으면 . FALSE

설명

이 메서드는 TB_GETCOLORSCHEME Windows SDK에 설명된 메시지를 보냅니다.

CToolBarCtrl::GetDisabledImageList

도구 모음 컨트롤이 비활성화된 단추를 표시하는 데 사용하는 이미지 목록을 검색합니다.

CImageList* GetDisabledImageList() const;

Return Value

개체에 대한 CImageList 포인터이거나 NULL 비활성화된 이미지 목록이 설정되지 않은 경우

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_GETDISABLEDIMAGELIST의 동작을 구현합니다. MFC 구현 GetDisabledImageList 에서는 이미지 목록에 대한 CImageList 핸들이 아닌 도구 모음 컨트롤의 단추 이미지가 포함된 개체를 사용합니다.

CToolBarCtrl::GetDropTarget

도구 모음 컨트롤의 IDropTarget 인터페이스를 검색합니다.

HRESULT GetDropTarget(IDropTarget** ppDropTarget) const;

매개 변수

ppDropTarget
인터페이스 포인터에 대한 포인터입니다 IDropTarget . 오류가 발생하면 포인터가 NULL 이 주소에 배치됩니다.

Return Value

HRESULT 작업의 성공 또는 실패를 나타내는 값을 반환합니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_GETOBJECT의 동작을 구현합니다.

CToolBarCtrl::GetExtendedStyle

도구 모음 컨트롤의 확장 스타일을 검색합니다.

DWORD GetExtendedStyle() const;

Return Value

DWORD 현재 도구 모음 컨트롤에 사용 중인 확장 스타일을 나타내는 A입니다. 스타일 목록은 Windows SDK의 도구 모음 확장 스타일을 참조하세요.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_GETEXTENDEDSTYLE의 동작을 구현합니다.

CToolBarCtrl::GetHotImageList

도구 모음 컨트롤이 "핫" 단추를 표시하는 데 사용하는 이미지 목록을 검색합니다. 마우스 포인터가 위에 있으면 핫 단추가 강조 표시됩니다.

CImageList* GetHotImageList() const;

Return Value

개체에 대한 CImageList 포인터이거나 NULL 비활성화된 이미지 목록이 설정되지 않은 경우

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_GETHOTIMAGELIST의 동작을 구현합니다. 마우스 포인터가 위에 있으면 핫 단추가 강조 표시됩니다.

CToolBarCtrl::GetHotItem

도구 모음에서 핫 항목의 인덱스를 검색합니다.

int GetHotItem() const;

Return Value

도구 모음에 있는 핫 항목의 인덱스(0부터 시작하는 인덱스)입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_GETHOTITEM의 동작을 구현합니다.

CToolBarCtrl::GetImageList

도구 모음 컨트롤이 단추를 기본 상태로 표시하는 데 사용하는 이미지 목록을 검색합니다.

CImageList* GetImageList() const;

Return Value

개체에 대한 CImageList 포인터이거나 NULL 이미지 목록이 설정되지 않은 경우

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_GETIMAGELIST의 동작을 구현합니다.

CToolBarCtrl::GetInsertMark

도구 모음의 현재 삽입 표시를 검색합니다.

void GetInsertMark(TBINSERTMARK* ptbim) const;

매개 변수

ptbim
삽입 표시를 TBINSERTMARK 받는 구조체에 대한 포인터입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_GETINSERTMARK의 동작을 구현합니다.

CToolBarCtrl::GetInsertMarkColor

도구 모음의 삽입 표시를 그리는 데 사용되는 색을 검색합니다.

COLORREF GetInsertMarkColor() const;

Return Value

COLORREF 현재 삽입 표시 색을 포함하는 값입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_GETINSERTMARKCOLOR의 동작을 구현합니다.

CToolBarCtrl::GetItemRect

도구 모음 컨트롤에서 단추의 경계 사각형을 검색합니다.

BOOL GetItemRect(
    int nIndex,
    LPRECT lpRect) const;

매개 변수

nIndex
정보를 검색할 단추의 인덱스(0부터 시작)입니다.

lpRect
경계 사각형의 RECT 좌표를 받는 구조체 또는 CRect 개체의 주소입니다.

Return Value

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

이 함수는 상태가 설정된 TBSTATE_HIDDEN단추의 경계 사각형을 검색하지 않습니다.

CToolBarCtrl::GetMaxSize

도구 모음에 표시되는 모든 단추 및 구분 기호의 총 크기를 검색합니다.

BOOL GetMaxSize(LPSIZE pSize) const;

매개 변수

pSize
항목의 크기를 받는 구조체에 대한 포인터 SIZE 입니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_GETMAXSIZE의 동작을 구현합니다.

CToolBarCtrl::GetMaxTextRows

도구 모음 단추에 표시되는 최대 텍스트 행 수를 검색합니다.

int GetMaxTextRows() const;

Return Value

도구 모음 단추에 표시되는 최대 텍스트 행 수입니다.

CToolBarCtrl::GetMetrics

개체의 메트릭을 CToolBarCtrl 검색합니다.

void GetMetrics(LPTBMETRICS ptbm) const;

매개 변수

ptbm
개체의 구조에 TBMETRICS 대한 포인터입니다 CToolBarCtrl .

설명

이 멤버 함수는 Windows SDK에 TB_GETMETRICS 설명된 대로 메시지의 기능을 에뮬레이트합니다.

CToolBarCtrl::GetPadding

현재 도구 모음 컨트롤의 가로 및 세로 안쪽 여백을 검색합니다.

BOOL GetPadding(
    int* pnHorzPadding,
    int* pnVertPadding) const;

매개 변수

pnHorzPadding
[out] 도구 모음 컨트롤의 가로 안쪽 여백을 픽셀 단위로 받는 정수입니다.

pnVertPadding
[out] 도구 모음 컨트롤의 세로 안쪽 여백을 픽셀 단위로 받는 정수입니다.

Return Value

TRUE이 메서드가 성공하면 이고, 그렇지 않으면 . FALSE

설명

이 메서드는 TB_GETPADDING Windows SDK에 설명된 메시지를 보냅니다.

CToolBarCtrl::GetPressedImageList

현재 도구 모음 컨트롤이 누름 상태의 단추를 나타내는 데 사용하는 이미지 목록을 검색합니다.

CImageList* GetPressedImageList();

Return Value

CImageList 현재 컨트롤에 대한 이미지 목록을 포함하는 포인터이거나 NULL 이러한 이미지 목록이 설정되지 않은 경우

설명

이 메서드는 TB_GETPRESSEDIMAGELIST Windows SDK에 설명된 메시지를 보냅니다.

CToolBarCtrl::GetRect

지정된 도구 모음 단추의 경계 사각형을 검색합니다.

BOOL GetRect(
    int nID,
    LPRECT lpRect) const;

매개 변수

nID
단추 식별자입니다.

lpRect
경계 사각형 정보를 받을 구조체에 대한 포인터 RECT 입니다.

Return Value

성공하면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_GETRECT의 동작을 구현합니다.

CToolBarCtrl::GetRows

도구 모음 컨트롤에 현재 표시되는 단추의 행 수를 검색합니다.

int GetRows() const;

Return Value

현재 도구 모음에 표시되는 단추의 행 수입니다.

설명

도구 모음이 스타일로 만들어지지 않는 한 행 수는 항상 1개 TBSTYLE_WRAPABLE 입니다.

CToolBarCtrl::GetState

도구 모음 컨트롤에서 지정된 단추의 상태(예: 사용 여부, 누름 또는 선택됨)에 대한 정보를 검색합니다.

int GetState(int nID) const;

매개 변수

nID
정보를 검색할 단추의 명령 식별자입니다.

Return Value

성공하거나 -1이면 단추 상태 정보입니다. 단추 상태 정보는 에 나열된 값의 조합일 수 있습니다 CToolBarCtrl::AddButtons.

설명

이 함수는 단추 상태 중 하나 이상을 검색하려는 경우에 특히 편리합니다. 하나의 상태를 검색하려면 다음 멤버 함수 중 하나를 사용합니다. IsButtonEnabledIsButtonCheckedIsButtonPressedIsButtonHiddenIsButtonIndeterminate 그러나 GetState 멤버 함수는 단추 상태를 검색 TBSTATE_WRAP 하는 유일한 방법입니다.

CToolBarCtrl::GetString

도구 모음 문자열을 검색합니다.

int GetString(
    int nString,
    LPTSTR lpstrString,
    int cchMaxLen) const;

int GetString(
    int nString,
    CString& str) const;

매개 변수

nString
문자열의 인덱스입니다.

lpstrString
문자열을 반환하는 데 사용되는 버퍼에 대한 포인터입니다.

cchMaxLen
버퍼의 길이(바이트)입니다.

str
문자열.

Return Value

성공하면 문자열의 길이입니다. 그렇지 않으면 -1입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_GETSTRING의 동작을 구현합니다.

CToolBarCtrl::GetStyle

도구 모음 컨트롤에 현재 적용된 스타일을 가져옵니다.

DWORD GetStyle() const;

Return Value

DWORD Windows SDK에 설명된 대로 도구 모음 컨트롤 스타일의 조합이 포함된 형식입니다.

CToolBarCtrl::GetToolTips

도구 모음 컨트롤과 연결된 도구 설명 컨트롤의 핸들(있는 경우)을 검색합니다.

CToolTipCtrl* GetToolTips() const;

Return Value

이 도구 모음과 연결된 개체에 CToolTipCtrl 대한 포인터이거나 NULL 도구 모음에 연결된 도구 설명 컨트롤이 없는 경우

설명

도구 모음 컨트롤은 일반적으로 자체 도구 설명 컨트롤을 만들고 유지 관리하므로 대부분의 프로그램에서 이 함수를 호출할 필요가 없습니다.

CToolBarCtrl::HitTest

도구 모음 컨트롤에서 점이 있는 위치를 결정합니다.

int HitTest(LPPOINT ppt) const;

매개 변수

ppt
멤버에 POINT 있는 적중 테스트의 x 좌표와 멤버에 있는 x 적중 테스트의 y 좌표를 포함하는 구조체에 y 대한 포인터입니다. 좌표는 도구 모음의 클라이언트 영역을 기준으로 합니다.

Return Value

도구 모음에서 점의 위치를 나타내는 정수 값입니다. 값이 0이거나 양수이면 이 반환 값은 점이 있는 비분석자 항목의 인덱스(0부터 시작하는 인덱스)입니다.

반환 값이 음수이면 단추 내에 있는 점이 아닙니다. 반환 값의 절대값은 구분 기호 항목 또는 가장 가까운 구분 기호가 아닌 항목의 인덱스입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_HITTEST의 동작을 구현합니다.

CToolBarCtrl::HideButton

도구 모음 컨트롤에서 지정된 단추를 숨기거나 표시합니다.

BOOL HideButton(
    int nID,
    BOOL bHide = TRUE);

매개 변수

nID
숨기거나 표시할 단추의 명령 식별자입니다.

bHide
TRUE 단추를 숨기려면 단추를 FALSE 표시합니다.

Return Value

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

단추 상태를 둘 이상 변경하려면 대신 호출 SetState 하는 것이 좋습니다.

CToolBarCtrl::Indeterminate

도구 모음 컨트롤에서 지정된 단추의 확정되지 않은 상태를 설정하거나 지웁니다.

BOOL Indeterminate(
    int nID,
    BOOL bIndeterminate = TRUE);

매개 변수

nID
확정되지 않은 상태를 설정하거나 지울 단추의 명령 식별자입니다.

bIndeterminate
TRUE 지정한 단추 FALSE 의 확정되지 않은 상태를 설정하여 지웁니다.

Return Value

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

확정되지 않은 단추는 선택한 텍스트에 굵게와 일반 문자가 모두 포함될 때 워드 프로세서 도구 모음의 굵게 단추가 표시되는 방식과 같이 회색으로 표시됩니다. 단추 상태를 둘 이상 변경하려면 대신 호출 SetState 하는 것이 좋습니다.

CToolBarCtrl::InsertButton

도구 모음 컨트롤에 단추를 삽입합니다.

BOOL InsertButton(
    int nIndex,
    LPTBBUTTON lpButton);

매개 변수

nIndex
단추의 0부터 시작하는 인덱스입니다. 이 함수는 이 단추의 왼쪽에 새 단추를 삽입합니다.

lpButton
삽입할 TBBUTTON 단추에 대한 정보가 포함된 구조체의 주소입니다. 구조에 대한 설명은 참조 CToolBarCtrl::AddButtons 하세요 TBBUTTON .

Return Value

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

제공된 인덱스가 이전에 , 및/또는 를 사용하여 AddBitmapAddString도구 모음 컨트롤의 목록에 추가되어야 하는 이미지 및/또는 AddStrings문자열입니다.

CToolBarCtrl::InsertMarkHitTest

도구 모음의 한 지점에 대한 삽입 표시 정보를 검색합니다.

BOOL InsertMarkHitTest(
    LPPOINT ppt,
    LPTBINSERTMARK ptbim) const;

매개 변수

ppt
도구 모음의 POINT 클라이언트 영역을 기준으로 적중 테스트 좌표를 포함하는 구조체에 대한 포인터입니다.

ptbim
삽입 표시 정보를 받는 구조체에 대한 포인터 TBINSERTMARK 입니다.

Return Value

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_INSERTMARKHITTEST의 동작을 구현합니다.

CToolBarCtrl::IsButtonChecked

도구 모음 컨트롤의 지정된 단추를 확인할지 여부를 결정합니다.

BOOL IsButtonChecked(int nID) const;

매개 변수

nID
도구 모음에 있는 단추의 명령 식별자입니다.

Return Value

단추가 선택되어 있으면 0이 아닌 경우 그렇지 않으면 0입니다.

설명

둘 이상의 단추 상태를 검색하려는 경우 호출 GetState 하는 것이 좋습니다.

CToolBarCtrl::IsButtonEnabled

도구 모음 컨트롤에서 지정된 단추를 사용할 수 있는지 여부를 확인합니다.

BOOL IsButtonEnabled(int nID) const;

매개 변수

nID
도구 모음에 있는 단추의 명령 식별자입니다.

Return Value

단추를 사용하는 경우 0이 아닌 경우 그렇지 않으면 0입니다.

설명

둘 이상의 단추 상태를 검색하려는 경우 호출 GetState 하는 것이 좋습니다.

CToolBarCtrl::IsButtonHidden

도구 모음 컨트롤의 지정된 단추가 숨겨져 있는지 여부를 확인합니다.

BOOL IsButtonHidden(int nID) const;

매개 변수

nID
도구 모음에 있는 단추의 명령 식별자입니다.

Return Value

단추가 숨겨진 경우 0이 아닌 경우 그렇지 않으면 0입니다.

설명

둘 이상의 단추 상태를 검색하려는 경우 호출 GetState 하는 것이 좋습니다.

CToolBarCtrl::IsButtonHighlighted

도구 모음 단추의 강조 표시 상태를 확인합니다.

BOOL IsButtonHighlighted(int nID) const;

매개 변수

nID
[in] 도구 모음 단추의 명령 ID입니다.

Return Value

단추가 강조 표시된 경우 양의 정수, 단추가 강조 표시되지 않으면 0, 오류가 발생하면 -1입니다.

CToolBarCtrl::IsButtonIndeterminate

도구 모음 컨트롤의 지정된 단추가 확정되지 않았는지 여부를 확인합니다.

BOOL IsButtonIndeterminate(int nID) const;

매개 변수

nID
[in] 도구 모음에 있는 단추의 명령 식별자입니다.

Return Value

단추가 확정되지 않은 경우 양의 정수, 단추가 확정되지 않은 경우 0, 오류가 발생하면 -1입니다.

설명

확정되지 않은 단추는 선택한 텍스트에 굵게와 일반 문자가 모두 포함될 때 워드 프로세서 도구 모음의 굵게 단추가 표시되는 방식과 같이 흐리게 표시됩니다. 둘 이상의 단추 상태를 검색하려는 경우 호출 GetState 하는 것이 좋습니다.

CToolBarCtrl::IsButtonPressed

도구 모음 컨트롤의 지정된 단추를 누를지 여부를 결정합니다.

BOOL IsButtonPressed(int nID) const;

매개 변수

nID
도구 모음에 있는 단추의 명령 식별자입니다.

Return Value

단추를 누르면 0이 아니고, 그렇지 않으면 0입니다.

설명

둘 이상의 단추 상태를 검색하려는 경우 호출 GetState 하는 것이 좋습니다.

CToolBarCtrl::LoadImages

비트맵을 도구 모음 컨트롤의 이미지 목록에 로드합니다.

void LoadImages(
    int iBitmapID,
    HINSTANCE hinst);

매개 변수

iBitmapID
로드할 이미지가 포함된 비트맵의 ID입니다. 고유한 비트맵 리소스를 지정하려면 이 매개 변수를 비트맵 리소스의 ID로 설정하고 .로 NULL설정합니다hInst. 비트맵 리소스가 이미지 목록에 단일 이미지로 추가됩니다. 이 매개 변수를 다음 ID 중 하나로 설정하고 설정 hinst HINST_COMMCTRL 하여 표준 시스템 정의 비트맵을 추가할 수 있습니다.

비트맵 ID	설명
IDB_HIST_LARGE_COLOR	큰 크기의 탐색기 비트맵
IDB_HIST_SMALL_COLOR	작은 크기의 탐색기 비트맵
IDB_STD_LARGE_COLOR	큰 크기의 표준 비트맵
IDB_STD_SMALL_COLOR	작은 크기의 표준 비트맵
IDB_VIEW_LARGE_COLOR	큰 크기의 비트맵 보기
IDB_VIEW_SMALL_COLOR	작은 크기의 비트맵 보기

hinst
호출 애플리케이션에 대한 프로그램 인스턴스 핸들입니다. 이 매개 변수는 표준 이미지 목록을 로드하는 것일 HINST_COMMCTRL 수 있습니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_LOADIMAGES의 동작을 구현합니다.

CToolBarCtrl::MapAccelerator

액셀러레이터 문자를 도구 모음 단추에 매핑합니다.

BOOL MapAccelerator(
    TCHAR chAccel,
    UINT* pIDBtn);

매개 변수

chAccel
매핑할 액셀러레이터 문자입니다. 이 문자는 단추의 텍스트에 밑줄이 그어지는 동일한 문자입니다.

pIDBtn
에 지정된 chAccel액셀러레이터에 해당하는 단추의 명령 식별자를 수신하는 포인터 UINT 입니다.

Return Value

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_MAPACCELERATOR의 동작을 구현합니다.

CToolBarCtrl::MarkButton

도구 모음 컨트롤에서 지정된 단추의 강조 표시 상태를 설정합니다.

BOOL MarkButton(
    int nID,
    BOOL fHighlight = TRUE);

매개 변수

nID
단추 식별자입니다.

fHighlight
설정할 강조 표시 상태를 지정합니다. 기본적으로 . TRUE 이 단추로 FALSE설정하면 단추가 기본 상태로 설정됩니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_MARKBUTTON의 동작을 구현합니다.

CToolBarCtrl::MoveButton

한 인덱스에서 다른 인덱스로 단추를 이동합니다.

BOOL MoveButton(
    UINT nOldPos,
    UINT nNewPos);

매개 변수

nOldPos
이동할 단추의 인덱스(0부터 시작)입니다.

nNewPos
단추 대상의 인덱스(0부터 시작하는 인덱스)입니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_MOVEBUTTON의 동작을 구현합니다.

CToolBarCtrl::PressButton

도구 모음 컨트롤에서 지정된 단추를 누르거나 놓습니다.

BOOL PressButton(int nID, BOOL bPress = TRUE);

매개 변수

nID
[in] 누르거나 놓을 단추의 명령 식별자입니다.

bPress
[in] TRUE 지정된 단추를 누르면 이고, FALSE 지정한 단추를 해제하려면 입니다. 기본값은 TRUE입니다.

Return Value

해당 메서드에 성공하면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

단추 상태를 둘 이상 변경하려면 대신 호출 SetState 하는 것이 좋습니다.

이 메서드는 TB_PRESSBUTTON Windows SDK에 설명된 메시지를 보냅니다.

CToolBarCtrl::ReplaceBitmap

현재 도구 모음 컨트롤의 기존 비트맵을 새 비트맵으로 바꿉니다.

BOOL ReplaceBitmap(LPTBREPLACEBITMAP pReplaceBitmap);

매개 변수

pReplaceBitmap
[in] TBREPLACEBITMAP 바꿀 비트맵과 새 비트맵을 설명하는 구조체에 대한 포인터입니다.

Return Value

TRUE이 메서드가 성공하면 이고, 그렇지 않으면 . FALSE

설명

이 메서드는 TB_REPLACEBITMAP Windows SDK에 설명된 메시지를 보냅니다.

예시

다음 코드 예제에서는 표준 도구 모음의 비트맵을 다른 비트맵으로 바꿉니다.

{
   // Replace one toolbar bitmap with another.
   TBREPLACEBITMAP tbrb;
   tbrb.hInstOld = ::AfxGetInstanceHandle();
   tbrb.nIDOld = IDR_MAINFRAME;
   tbrb.hInstNew = ::AfxGetInstanceHandle();
   tbrb.nIDNew = IDR_MAINFRAME1;
   tbrb.nButtons = 8;
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   BOOL bRet = m_toolBarCtrl.ReplaceBitmap(&tbrb);
}

CToolBarCtrl::RestoreState

매개 변수로 지정된 레지스트리의 위치에서 도구 모음 컨트롤의 상태를 복원합니다.

void RestoreState(
    HKEY hKeyRoot,
    LPCTSTR lpszSubKey,
    LPCTSTR lpszValueName);

매개 변수

hKeyRoot
레지스트리 또는 다음 미리 정의된 예약 핸들 값 중에서 현재 열려 있는 키를 식별합니다.

• HKEY_CLASSES_ROOT

• HKEY_CURRENT_USER

• HKEY_LOCAL_MACHINE

• HKEY_USERS

lpszSubKey
값이 NULL연결된 하위 키의 이름을 포함하는 종결 문자열을 가리킵니다. 이 매개 변수는 NULL 빈 문자열에 대한 포인터이거나 포인터일 수 있습니다. 매개 변수인 NULL경우 매개 변수로 식별된 키에 값이 hKeyRoot 추가됩니다.

lpszValueName
검색할 값의 이름을 포함하는 문자열을 가리킵니다. 이 이름의 값이 아직 키에 없는 경우 함수는 키에 값을 추가합니다.

CToolBarCtrl::SaveState

매개 변수로 지정된 레지스트리의 위치에 도구 모음 컨트롤의 상태를 저장합니다.

void SaveState(
    HKEY hKeyRoot,
    LPCTSTR lpszSubKey,
    LPCTSTR lpszValueName);

매개 변수

hKeyRoot
레지스트리 또는 다음 미리 정의된 예약 핸들 값 중에서 현재 열려 있는 키를 식별합니다.

• HKEY_CLASSES_ROOT

• HKEY_CURRENT_USER

• HKEY_LOCAL_MACHINE

• HKEY_USERS

lpszSubKey
값이 NULL연결된 하위 키의 이름을 포함하는 종결 문자열을 가리킵니다. 이 매개 변수는 NULL 빈 문자열에 대한 포인터이거나 포인터일 수 있습니다. 매개 변수인 NULL경우 매개 변수로 식별된 키에 값이 hKeyRoot 추가됩니다.

lpszValueName
설정할 값의 이름을 포함하는 문자열을 가리킵니다. 이 이름의 값이 아직 키에 없는 경우 함수는 키에 값을 추가합니다.

CToolBarCtrl::SetAnchorHighlight

도구 모음의 앵커 강조 표시 설정을 지정합니다.

BOOL SetAnchorHighlight(BOOL fAnchor = TRUE);

매개 변수

fAnchor
[in] 앵커 강조 표시를 사용하도록 설정하거나 사용하지 않도록 설정할지 여부를 지정합니다. 이 값이 0이 아닌 경우 앵커 강조 표시가 사용하도록 설정됩니다. 이 값이 0이면 앵커 강조 표시가 비활성화됩니다.

Return Value

이전 앵커 설정입니다. 강조 표시를 사용하도록 설정한 경우 이 값은 0이 아닌 값입니다. 강조 표시를 사용하도록 설정하지 않은 경우 이 값은 0입니다.

설명

이 메서드는 Windows SDK에 설명된 대로 Win32 메시지 TB_SETANCHORHIGHLIGHT의 동작을 구현합니다.

CToolBarCtrl::SetBitmapSize

도구 모음 컨트롤에 추가할 실제 비트맵 이미지의 크기를 설정합니다.

BOOL SetBitmapSize(CSize size);

매개 변수

size
비트맵 이미지의 너비 및 높이(픽셀)입니다.

Return Value

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

이 함수는 도구 모음에 비트맵을 추가하기 전에 호출해야 합니다. 애플리케이션이 비트맵 크기를 명시적으로 설정하지 않으면 기본값은 16 x 15픽셀입니다.

CToolBarCtrl::SetButtonInfo

도구 모음의 기존 단추에 대한 정보를 설정합니다.

BOOL SetButtonInfo(
    int nID,
    TBBUTTONINFO* ptbbi);

매개 변수

nID
단추 식별자입니다.

ptbbi
단추 정보를 받는 구조체에 대한 포인터 TBBUTTONINFO 입니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

설명

멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_SETBUTTONINFO의 동작을 구현합니다.

CToolBarCtrl::SetButtonSize

도구 모음 컨트롤의 단추 크기를 설정합니다.

BOOL SetButtonSize(CSize size);

매개 변수

size
단추의 너비와 높이(픽셀)입니다.

Return Value

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

단추 크기는 항상 묶는 비트맵 크기만큼 커야 합니다. 이 함수는 도구 모음에 비트맵을 추가하기 전에 호출해야 합니다. 애플리케이션이 단추 크기를 명시적으로 설정하지 않으면 기본적으로 24 x 22픽셀로 설정됩니다.

예시

CToolBar::GetToolBarCtrl에 대한 예를 참조하세요.

CToolBarCtrl::SetButtonStructSize

구조체의 크기를 지정합니다 TBBUTTON .

void SetButtonStructSize(int nSize);

매개 변수

nSize
구조체의 크기(바이트)입니다 TBBUTTON .

설명

구조체에 TBBUTTON 추가 데이터를 저장하려는 경우 새 구조 TBBUTTON체를 파생하거나 필요한 멤버를 추가하거나 구조체를 첫 번째 멤버로 포함하는 TBBUTTON 새 구조를 만들 수 있습니다. 그런 다음 이 함수를 호출하여 도구 모음에 새 구조체의 크기를 제어하도록 지시합니다.

구조에 대한 자세한 내용은 참조 CToolBarCtrl::AddButtons 하세요 TBBUTTON .

CToolBarCtrl::SetButtonWidth

도구 모음 컨트롤의 최소 및 최대 단추 너비를 설정합니다.

BOOL SetButtonWidth(
    int cxMin,
    int cxMax);

매개 변수

cxMin
최소 단추 너비(픽셀)입니다. 도구 모음 단추는 이 값보다 좁지 않습니다.

cxMax
최대 단추 너비(픽셀)입니다. 단추 텍스트가 너무 넓으면 컨트롤에 줄임표 점이 표시됩니다.

Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_SETBUTTONWIDTH의 동작을 구현합니다.

CToolBarCtrl::SetCmdID

지정한 단추를 누를 때 소유자 창으로 보낼 명령 식별자를 설정합니다.

BOOL SetCmdID(
    int nIndex,
    UINT nID);

매개 변수

nIndex
명령 ID를 설정할 단추의 인덱스(0부터 시작)입니다.

nID
선택한 단추를 설정할 명령 ID입니다.

Return Value

성공하면 0이 아닌 값을 반환합니다. 그렇지 않으면 0입니다.

CToolBarCtrl::SetColorScheme

현재 도구 모음 컨트롤의 색 구성표를 설정합니다.

void SetColorScheme(const COLORSCHEME* lpColorScheme);

매개 변수

lpColorScheme
[in] 도구 모음 컨트롤의 COLORSCHEME 강조 색과 그림자 색을 설명하는 구조체에 대한 포인터입니다.

설명

Windows Vista 시각적 테마가 설정된 경우에는 이 메서드가 적용되지 않습니다.

이 메서드는 TB_SETCOLORSCHEME Windows SDK에 설명된 메시지를 보냅니다.

예시

다음은 현재 도구 모음 컨트롤의 색 구성표를 설정하는 코드 예제입니다. 코드 예제에서는 각 도구 단추의 왼쪽 및 위쪽 가장자리를 빨간색으로, 오른쪽 및 아래쪽 가장자리를 파란색으로 만듭니다. 사용자가 단추를 누르면 단추의 빨간색 가장자리가 파란색으로 바뀌고 파란색 가장자리가 빨간색으로 바뀝니다.

//Set color scheme for the current toolbar control.
//Make the left and top edges of the tool button red,
//and the right and bottom edges blue. The colors
//reverse when a button is pressed.
//This method has no effect if the Vista visual theme
//is set.
{
   COLORSCHEME cs;
   cs.dwSize = sizeof(COLORSCHEME);
   cs.clrBtnHighlight = RGB(255, 0, 0);
   cs.clrBtnShadow = RGB(0, 0, 255);
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   m_toolBarCtrl.SetColorScheme(&cs);
}

CToolBarCtrl::SetDisabledImageList

도구 모음 컨트롤이 비활성화된 단추를 표시하는 데 사용할 이미지 목록을 설정합니다.

CImageList* SetDisabledImageList(CImageList* pImageList);

매개 변수

pImageList
도구 모음 컨트롤에서 CImageList 사용하지 않도록 설정된 단추 이미지를 표시하는 데 사용할 이미지가 포함된 개체에 대한 포인터입니다.

Return Value

이전에 도구 모음 컨트롤에서 사용하지 않도록 설정된 단추 이미지를 표시하는 데 사용한 개체에 대한 포인터 CImageList 입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_SETDISABLEDIMAGELIST의 동작을 구현합니다. MFC 구현 SetDisabledImageList 에서는 이미지 목록에 대한 CImageList 핸들이 아니라 도구 모음 컨트롤의 비활성화된 단추 이미지가 포함된 개체를 사용합니다.

CToolBarCtrl::SetDrawTextFlags

지정된 사각형에 텍스트를 그리는 데 사용되는 Win32 함수 DrawText의 플래그를 설정하며 플래그 설정 방식에 따라 서식이 지정됩니다.

DWORD SetDrawTextFlags(
    DWORD dwMask,
    DWORD dwDTFlags);

매개 변수

dwMask
Win32 함수DrawText에 지정된 하나 이상의 DT_ 플래그 조합으로, 텍스트를 그릴 때 사용할 비트를 dwDTFlags 나타냅니다.

dwDTFlags
단추 텍스트를 그리는 방법을 나타내는 Win32 함수DrawText에 지정된 하나 이상의 DT_ 플래그 조합입니다. 이 값은 단추 텍스트를 그릴 때 전달 DrawText 됩니다.

Return Value

DWORD 이전 텍스트 그리기 플래그를 포함하는 항목입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_SETDRAWTEXTFLAGS의 동작을 구현합니다. 이 멤버 함수는 플래그를 설정하는 방법에 따라 서식이 지정된 사각형에 텍스트를 그리는 Win32 함수 DrawText의 플래그를 설정합니다.

CToolBarCtrl::SetExtendedStyle

도구 모음 컨트롤의 확장 스타일을 설정합니다.

DWORD SetExtendedStyle(DWORD dwExStyle);

매개 변수

dwExStyle
새 확장 스타일을 지정하는 값입니다. 이 매개 변수는 도구 모음 확장 스타일의 조합일 수 있습니다.

Return Value

이전 확장 스타일을 나타내는 A DWORD 입니다. 스타일 목록은 Windows SDK의 도구 모음 확장 스타일을 참조하세요.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_SETEXTENDEDSTYLE의 동작을 구현합니다.

CToolBarCtrl::SetHotImageList

도구 모음 컨트롤이 "핫" 단추를 표시하는 데 사용할 이미지 목록을 설정합니다.

CImageList* SetHotImageList(CImageList* pImageList);

매개 변수

pImageList
도구 모음 컨트롤에서 CImageList 핫 단추 이미지를 표시하는 데 사용할 이미지가 포함된 개체에 대한 포인터입니다.

Return Value

이전에 도구 모음 컨트롤에서 핫 단추 이미지를 표시하는 데 사용한 개체에 대한 포인터 CImageList 입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_SETHOTIMAGELIST의 동작을 구현합니다.

MFC 구현 SetHotImageList 에서는 이미지 목록에 대한 CImageList 핸들이 아닌 도구 모음 컨트롤의 핫 단추 이미지가 포함된 개체를 사용합니다. 포인터가 위에 있으면 핫 단추가 강조 표시됩니다.

CToolBarCtrl::SetHotItem

도구 모음에서 핫 항목을 설정합니다.

int SetHotItem(int nHot);

매개 변수

nHot
핫이 될 항목의 인덱스 번호(0부터 시작)입니다. 이 값이 -1이면 어떤 항목도 핫 항목이 되지 않습니다.

Return Value

이전 핫 항목의 인덱스이거나, 핫 항목이 없는 경우 -1입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_SETHOTITEM의 동작을 구현합니다.

CToolBarCtrl::SetImageList

도구 모음에서 기본 상태의 단추를 표시하는 데 사용할 이미지 목록을 설정합니다.

CImageList* SetImageList(CImageList* pImageList);

매개 변수

pImageList
도구 모음 컨트롤에서 단추 이미지를 기본 상태로 표시하는 데 사용할 이미지가 포함된 개체에 대한 포인터 CImageList 입니다.

Return Value

이전에 도구 모음 컨트롤에서 단추 이미지를 기본 상태로 표시하는 데 사용한 개체에 대한 포인터 CImageList 입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_SETIMAGELIST의 동작을 구현합니다.

MFC 구현 SetImageList 에서는 이미지 목록에 대한 CImageList 핸들이 아닌 도구 모음 컨트롤의 단추 이미지가 포함된 개체를 사용합니다.

CToolBarCtrl::SetIndent

도구 모음 컨트롤의 첫 번째 단추에 대한 들여쓰기를 설정합니다.

BOOL SetIndent(int iIndent);

매개 변수

iIndent
들여쓰기를 지정하는 값(픽셀)입니다.

Return Value

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

CToolBarCtrl::SetInsertMark

도구 모음의 현재 삽입 표시를 설정합니다.

void SetInsertMark(TBINSERTMARK* ptbim);

매개 변수

ptbim
삽입 표시가 TBINSERTMARK 포함된 구조체에 대한 포인터입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_SETINSERTMARK의 동작을 구현합니다.

CToolBarCtrl::SetInsertMarkColor

도구 모음의 삽입 표시를 그리는 데 사용되는 색을 설정합니다.

COLORREF SetInsertMarkColor(COLORREF clrNew);

매개 변수

clrNew
COLORREF 새 삽입 표시 색을 포함하는 값입니다.

Return Value

COLORREF 이전 삽입 표시 색을 포함하는 값입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 Win32 메시지 TB_SETINSERTMARKCOLOR의 동작을 구현합니다.

CToolBarCtrl::SetMaxTextRows

도구 모음 단추에 표시되는 최대 텍스트 행 수를 설정합니다.

BOOL SetMaxTextRows(int iMaxRows);

매개 변수

iMaxRows
설정할 최대 행 수입니다.

Return Value

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

CToolBarCtrl::SetMetrics

개체의 메트릭을 CToolBarCtrl 설정합니다.

void SetMetrics(LPTBMETRICS ptbm);

매개 변수

ptbm
개체의 구조에 TBMETRICS 대한 포인터입니다 CToolBarCtrl .

설명

이 멤버 함수는 Windows SDK에 TB_SETMETRICS 설명된 대로 메시지의 기능을 에뮬레이트합니다.

CToolBarCtrl::SetOwner

도구 모음 컨트롤의 소유자 창을 설정합니다.

void SetOwner(CWnd* pWnd);

매개 변수

pWnd
도구 모음 컨트롤의 CWnd 새 소유자 창이 될 또는 CWnd파생된 개체에 대한 포인터입니다.

설명

소유자 창은 도구 모음에서 알림을 받는 창입니다.

CToolBarCtrl::SetPadding

현재 도구 모음 컨트롤의 가로 및 세로 안쪽 여백을 설정합니다.

DWORD SetPadding(
    int nHorzPadding,
    int nVertPadding);

매개 변수

nHorzPadding
[in] 도구 모음 컨트롤의 가로 안쪽 여백을 픽셀 단위로 지정합니다.

nVertPadding
[in] 도구 모음 컨트롤의 세로 안쪽 여백을 픽셀 단위로 지정합니다.

Return Value

DWORD 낮은 단어에 이전 가로 안쪽 여백 값이 포함되고 높은 단어에 이전 세로 안쪽 여백 값이 포함된 단어입니다. 패딩 값은 픽셀 단위로 측정됩니다.

설명

이 메서드는 TB_SETPADDING Windows SDK에 설명된 메시지를 보냅니다.

예시

다음은 현재 도구 모음 컨트롤의 가로 및 세로 안쪽 여백을 20픽셀로 설정하는 코드 예제입니다.

{
   // Set the horizontal and vertical padding of the current
   // toolbar control.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   m_toolBarCtrl.SetPadding(50, 50);
}

CToolBarCtrl::SetPressedImageList

현재 도구 모음 컨트롤이 누른 상태의 단추를 나타내는 데 사용하는 이미지 목록을 설정합니다.

CImagelist* SetPressedImageList(
    int iImageID,
    CImageList* pImageList);

매개 변수

iImageID
[in] 이미지 목록의 인덱스(0부터 시작하는 인덱스)입니다. 이미지 목록을 하나만 사용하는 경우 이 매개 변수를 0으로 설정합니다.

pImageList
[in] CImageList 새 이미지 목록을 포함하는 포인터입니다.

Return Value

CImageList 현재 컨트롤에 대한 이전 이미지 목록을 포함하는 포인터이거나 NULL 이러한 이미지 목록이 설정되지 않은 경우

설명

이 메서드는 TB_SETPRESSEDIMAGELIST Windows SDK에 설명된 메시지를 보냅니다.

예시

다음은 누른 이미지 목록을 기본 이미지 목록과 동일하게 설정하는 코드 예제입니다.

{
   // SetPressedImageList
   // Set the pressed image list to be the same as the
   // normal image list.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   CImageList *pNormalCil = m_toolBarCtrl.GetImageList();
   CImageList *pPressedCil = m_toolBarCtrl.GetPressedImageList();
   m_toolBarCtrl.SetPressedImageList(0, pNormalCil);
}

CToolBarCtrl::SetRows

도구 모음 컨트롤에 요청된 행 수로 크기를 조정하도록 요청합니다.

void SetRows(
    int nRows,
    BOOL bLarger,
    LPRECT lpRect);

매개 변수

nRows
요청된 행 수입니다.

bLarger
도구 모음의 크기를 요청된 행 수로 조정할 수 없는 경우 더 많은 행 또는 더 적은 행을 사용할지 여부를 알려줍니다.

lpRect
도구 모음의 CRect 새 경계 사각형을 받을 개체 또는 RECT 구조를 가리킵니다.

설명

도구 모음의 크기를 요청된 숫자 또는 행으로 조정할 수 없는 경우 값 bLarger에 따라 크기가 다음으로 크거나 다음으로 더 작은 유효한 크기로 조정됩니다. 이 TRUE경우 bLarger 새 행 수가 요청된 수보다 큽니다. 이 FALSE경우 bLarger 새 행 수는 요청된 수보다 작습니다.

단추를 정렬할 수 있는 경우 지정된 개수의 행이 도구 모음에 유효하여 모든 행에 동일한 수의 단추가 있습니다(마지막 행 제외). 예를 들어 마지막 두 행이 더 짧아야 하므로 4개의 단추가 포함된 도구 모음의 크기를 3개 행으로 지정할 수 없습니다. 3개의 행으로 크기를 조정하려고 하면 4개의 행(있는 경우 bLarger TRUE )과 2개의 행(있는 경우 bLarger FALSE)을 얻게 됩니다.

도구 모음에 구분 기호가 있는 경우 지정된 수의 행이 유효한 경우에 대한 규칙은 더 복잡합니다. 그룹이 한 행에 맞지 않는 한 단추 그룹(첫 번째 및 그룹의 마지막 단추 앞에 구분 기호가 있는 단추)이 여러 행에서 분할되지 않도록 레이아웃이 계산됩니다.

그룹이 한 행에 맞지 않으면 큰 그룹이 종료된 행에 맞더라도 다음 그룹이 다음 행에서 시작됩니다. 이 규칙의 목적은 큰 그룹 간의 분리를 더 눈에 띄게 만드는 것입니다. 결과 세로 구분 기호는 행으로 계산됩니다.

또한 멤버 함수는 SetRows 항상 도구 모음 크기가 가장 작은 레이아웃을 선택합니다. 스타일을 사용하여 도구 모음을 TBSTYLE_WRAPABLE 만든 다음 컨트롤의 크기를 조정하면 컨트롤의 너비를 고려할 때 위에 설명된 메서드를 적용하기만 하면 됩니다.

이 함수는 스타일로 만든 TBSTYLE_WRAPABLE 도구 모음에 대해서만 호출할 수 있습니다.

CToolBarCtrl::SetState

도구 모음 컨트롤에서 지정된 단추의 상태를 설정합니다.

BOOL SetState(
    int nID,
    UINT nState);

매개 변수

nID
단추의 명령 식별자입니다.

nState
상태 플래그입니다. 단추 상태에 대해 나열된 값의 조합일 수 있습니다 CToolBarCtrl::AddButtons.

Return Value

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

이 함수는 단추 상태를 둘 이상 설정하려는 경우에 특히 편리합니다. 하나의 상태를 설정하려면 다음 멤버 함수 중 하나를 사용합니다. EnableButtonCheckButtonHideButtonIndeterminatePressButton

CToolBarCtrl::SetStyle

도구 모음 컨트롤의 스타일을 설정합니다.

void SetStyle(DWORD dwStyle);

매개 변수

dwStyle
DWORD Windows SDK에 설명된 대로 도구 모음 컨트롤 스타일의 조합이 포함된 형식입니다.

CToolBarCtrl::SetToolTips

도구 설명 컨트롤을 도구 모음 컨트롤과 연결합니다.

void SetToolTips(CToolTipCtrl* pTip);

매개 변수

pTip
개체에 대한 포인터입니다 CToolTipCtrl .

CToolBarCtrl::SetWindowTheme

개체의 CToolBarCtrl 비주얼 스타일을 설정합니다.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

매개 변수

pszSubAppName
설정할 도구 모음 비주얼 스타일을 포함하는 유니코드 문자열에 대한 포인터입니다.

Return Value

반환 값은 사용되지 않습니다.

설명

이 멤버 함수는 Windows SDK에 TB_SETWINDOWTHEME 설명된 대로 메시지의 기능을 에뮬레이트합니다.

참고 항목

MFC 샘플 CMNCTRL1
MFC 샘플 MFCIE
CWnd 클래스
계층 구조 차트
CToolBar 클래스