CMFCToolBar 수업

클래스는 CMFCToolBar 클래스와 CToolBar 비슷하지만 사용자 인터페이스 기능에 대한 추가 지원을 제공합니다. 여기에는 평면 도구 모음, 핫 이미지 포함 도구 모음, 큰 아이콘, 페이저 단추, 잠긴 도구 모음, rebar 컨트롤, 이미지 아래 텍스트, 배경 이미지, 탭 도구 모음이 포함됩니다. CMFCToolBar 클래스에는 기본 제공 사용자 지정 도구 모음과 메뉴, 메뉴 사이 끌어 놓기, 콤보 상자 단추, 편집 상자 단추, 색 선택 및 롤업 단추 도구 모음이 포함됩니다.

자세한 내용은 Visual Studio 설치에 있는 소스 코드(예: ) %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc를 참조하세요.

구문

class CMFCToolBar : public CMFCBaseToolBar

멤버

공용 생성자

속성	설명
CMFCToolBar::CMFCToolBar	기본 생성자입니다.
CMFCToolBar::~CMFCToolBar	소멸자

공용 메서드

이름	설명
CMFCToolBar::AddBasicCommand	사용자가 메뉴를 열 때 항상 표시되는 명령 목록에 메뉴 명령을 추가합니다.
CMFCToolBar::AddCommandUsage	지정된 명령과 연결된 카운터를 하나씩 증분합니다.
CMFCToolBar::AddToolBarForImageCollection	사용자 인터페이스 리소스의 이미지를 애플리케이션의 이미지 컬렉션에 추가합니다.
CMFCToolBar::AdjustLayout	도구 모음의 크기와 위치를 다시 계산합니다. (CBasePane::AdjustLayout재정의)
CMFCToolBar::AdjustSize	도구 모음의 크기를 다시 계산합니다.
CMFCToolBar::AllowChangeTextLabels	도구 모음 단추의 이미지 아래에 텍스트 레이블을 표시할 수 있는지 여부를 지정합니다.
CMFCToolBar::AreTextLabels	이미지 아래의 텍스트 레이블이 현재 도구 모음 단추에 표시되는지 여부를 지정합니다.
CMFCToolBar::AutoGrayInactiveImages	비활성 단추 이미지의 자동 생성을 사용하거나 사용하지 않도록 설정합니다.
CMFCToolBar::ButtonToIndex	이 도구 모음에서 지정된 CMFCToolBarButton Class 개체의 인덱스 값을 반환합니다.
CMFCToolBar::CalcFixedLayout	도구 모음의 가로 크기를 계산합니다. ( CBasePane::CalcFixedLayout을 재정의합니다.)
CMFCToolBar::CalcSize	레이아웃 계산 프로세스의 일부로 프레임워크에서 호출됩니다. ( CPane::CalcSize을 재정의합니다.)
CMFCToolBar::CanHandleSiblings	도구 모음 및 해당 형제를 동일한 창에 배치할지를 결정합니다.
CMFCToolBar::CleanUpImages	도구 모음 이미지에 할당된 시스템 리소스를 해제합니다.
CMFCToolBar::CleanUpLockedImages	잠긴 도구 모음 이미지에 할당된 시스템 리소스를 해제합니다.
CMFCToolBar::CanBeClosed	사용자가 도구 모음을 닫을 수 있는지 여부를 지정합니다. ( CBasePane::CanBeClosed을 재정의합니다.)
CMFCToolBar::CanBeRestored	시스템이 사용자 지정 후 도구 모음을 원래 상태로 복원할 수 있는지 여부를 결정합니다.
CMFCToolBar::CanFocus	창에서 포커스를 받을 수 있는지 여부를 지정합니다. ( CBasePane::CanFocus을 재정의합니다.)
CMFCToolBar::CanHandleSiblings	도구 모음 및 해당 형제를 동일한 창에 배치할지를 결정합니다.
CMFCToolBar::CommandToIndex	지정된 명령 ID를 사용하여 도구 모음에 있는 단추의 인덱스 값을 반환합니다.
CMFCToolBar::Create	CMFCToolBar 개체를 만듭니다.
CMFCToolBar::CreateEx	CMFCToolBar 큰 아이콘과 같은 추가 스타일 옵션을 사용하는 개체를 만듭니다.
CMFCToolBar::Deactivate	도구 모음을 비활성화합니다.
CMFCToolBar::EnableCustomizeButton	도구 모음 끝에 나타나는 단추 추가 또는 제거 단추를 사용하거나 사용하지 않도록 설정합니다.
CMFCToolBar::EnableDocking	창을 주 프레임에 도킹할 수 있습니다. ( CBasePane::EnableDocking을 재정의합니다.)
CMFCToolBar::EnableLargeIcons	도구 모음 단추에서 큰 아이콘을 사용하거나 사용하지 않도록 설정합니다.
CMFCToolBar::EnableQuickCustomization	사용자가 Alt 키를 누르고 단추를 새 위치로 끌 수 있도록 도구 모음의 빠른 사용자 지정을 사용하거나 사용하지 않도록 설정합니다.
CMFCToolBar::EnableReflections	명령 리플렉션을 사용하거나 사용하지 않도록 설정합니다.
CMFCToolBar::EnableTextLabels	도구 모음 단추 이미지에서 텍스트 레이블을 사용하거나 사용하지 않도록 설정합니다.
CMFCToolBar::FromHandlePermanent	지정된 창 핸들이 포함된 개체에 CMFCToolBar 대한 포인터를 검색합니다.
CMFCToolBar::GetAllButtons	도구 모음에 있는 단추의 읽기 전용 목록을 반환합니다.
CMFCToolBar::GetAllToolbars	애플리케이션에 있는 모든 도구 모음의 읽기 전용 목록을 반환합니다.
CMFCToolBar::GetBasicCommands	애플리케이션에 정의된 기본 명령의 읽기 전용 목록을 반환합니다.
CMFCToolBar::GetButton	지정된 도구 모음 단추 인덱스가 CMFCToolBarButton 있는 개체에 대한 포인터를 반환합니다.
CMFCToolBar::GetButtonInfo	지정된 인덱스에서 단추의 명령 ID, 스타일 및 이미지 인덱스 값을 반환합니다.
CMFCToolBar::GetButtonSize	도구 모음에서 각 단추의 크기를 반환합니다.
CMFCToolBar::GetButtonStyle	지정된 인덱스 위치에 있는 도구 모음 단추의 현재 스타일을 반환합니다.
CMFCToolBar::GetButtonText	지정된 인덱스가 있는 단추의 텍스트 레이블을 반환합니다.
CMFCToolBar::GetColdImages	애플리케이션의 콜드 도구 모음 단추 이미지 컬렉션에 대한 포인터를 반환합니다.
CMFCToolBar::GetColumnWidth	도구 모음 단추의 너비를 반환합니다.
CMFCToolBar::GetCommandButtons	애플리케이션의 모든 도구 모음에서 지정된 명령 ID가 있는 단추 목록을 반환합니다.
CMFCToolBar::GetCount	도구 모음의 단추 및 구분 기호 수를 반환합니다.
CMFCToolBar::GetCustomizeButton	도구 모음과 연결된 개체에 CMFCCustomizeButton 대한 포인터를 검색합니다.
CMFCToolBar::GetDefaultImage	지정된 명령 ID를 사용하여 도구 모음 단추에 대한 기본 이미지의 인덱스 값을 반환합니다.
CMFCToolBar::GetDisabledImages	애플리케이션에서 사용하지 않도록 설정된 도구 모음 단추에 사용되는 이미지 컬렉션에 대한 포인터를 반환합니다.
CMFCToolBar::GetDisabledMenuImages	애플리케이션에서 비활성화된 메뉴 단추에 사용되는 이미지 컬렉션에 대한 포인터를 반환합니다.
CMFCToolBar::GetDroppedDownMenu	현재 하위 메뉴를 표시하는 메뉴 단추 개체에 대한 포인터를 검색합니다.
CMFCToolBar::GetGrayDisabledButtons	비활성화된 단추의 이미지가 일반 단추 이미지의 흐리게 표시된 버전인지 또는 비활성화된 단추 이미지 컬렉션에서 가져온 것인지를 지정합니다.
CMFCToolBar::GetHighlightedButton	현재 강조 표시된 도구 모음 단추에 대한 포인터를 반환합니다.
CMFCToolBar::GetHotBorder	도구 모음 단추가 핫 트랙되는지 여부를 확인합니다.
CMFCToolBar::GetHotTextColor	강조 표시된 도구 모음 단추의 텍스트 색을 반환합니다.
CMFCToolBar::GetHwndLastFocus	도구 모음이 실행되기 직전에 입력 포커스가 있는 창에 핸들을 반환합니다.
CMFCToolBar::GetIgnoreSetText	단추 레이블을 설정하는 호출이 무시되는지 여부를 지정합니다.
CMFCToolBar::GetImageSize	도구 모음 단추 이미지의 현재 크기를 반환합니다.
CMFCToolBar::GetImages	애플리케이션의 기본 단추 이미지 컬렉션에 대한 포인터를 반환합니다.
CMFCToolBar::GetImagesOffset	도구 모음 단추 이미지의 전역 목록에서 이 도구 모음의 도구 모음 단추 이미지를 찾는 데 사용되는 인덱스 오프셋을 반환합니다.
CMFCToolBar::GetInvalidateItemRect	지정된 인덱스의 단추에 대해 다시 그려야 하는 클라이언트 영역의 영역을 검색합니다.
CMFCToolBar::GetItemID	지정된 인덱스에서 도구 모음 단추의 명령 ID를 반환합니다.
CMFCToolBar::GetItemRect	지정된 인덱스에서 단추의 경계 사각형을 반환합니다.
CMFCToolBar::GetLargeColdImages	애플리케이션의 큰 콜드 도구 모음 단추 이미지 컬렉션에 대한 포인터를 반환합니다.
CMFCToolBar::GetLargeDisabledImages	애플리케이션에서 사용하지 않도록 설정된 큰 도구 모음 단추 이미지 컬렉션에 대한 포인터를 반환합니다.
CMFCToolBar::GetLargeImages	애플리케이션의 큰 도구 모음 단추 이미지 컬렉션에 대한 포인터를 반환합니다.
CMFCToolBar::GetLockedColdImages	도구 모음에서 잠긴 콜드 이미지 컬렉션에 대한 포인터를 반환합니다.
CMFCToolBar::GetLockedDisabledImages	도구 모음에서 잠긴 비활성화된 이미지 컬렉션에 대한 포인터를 반환합니다.
CMFCToolBar::GetLockedImages	도구 모음에서 잠긴 단추 이미지 컬렉션에 대한 포인터를 반환합니다.
CMFCToolBar::GetLockedImageSize	잠긴 도구 모음 이미지의 기본 크기를 반환합니다.
CMFCToolBar::GetLockedMenuImages	도구 모음의 잠긴 도구 모음 메뉴 이미지 컬렉션에 대한 포인터를 반환합니다.
CMFCToolBar::GetMenuButtonSize	애플리케이션의 메뉴 단추 크기를 반환합니다.
CMFCToolBar::GetMenuImageSize	애플리케이션의 메뉴 단추 이미지 크기를 반환합니다.
CMFCToolBar::GetMenuImages	애플리케이션의 메뉴 단추 이미지 컬렉션에 대한 포인터를 반환합니다.
CMFCToolBar::GetOrigButtons	도구 모음의 사용자 지정되지 않은 단추 컬렉션을 검색합니다.
CMFCToolBar::GetOrigResetButtons	도구 모음의 사용자 지정되지 않은 재설정 단추 컬렉션을 검색합니다.
CMFCToolBar::GetResourceID	도구 모음의 리소스 ID를 검색합니다.
CMFCToolBar::GetRouteCommandsViaFrame	도구 모음에 명령을 보내는 개체, 부모 프레임 또는 소유자를 결정합니다.
CMFCToolBar::GetRowHeight	도구 모음 단추의 높이를 반환합니다.
CMFCToolBar::GetShowTooltips	도구 모음 단추에 대한 도구 팁을 표시할지 여부를 지정합니다.
CMFCToolBar::GetSiblingToolBar	도구 모음의 형제를 검색합니다.
CMFCToolBar::GetUserImages	애플리케이션에서 사용자 정의 도구 모음 단추 이미지 컬렉션에 대한 포인터를 반환합니다.
CMFCToolBar::HitTest	지정된 위치에 있는 도구 모음 단추의 인덱스 값을 반환합니다.
CMFCToolBar::InsertButton	도구 모음에 단추를 삽입합니다.
CMFCToolBar::InsertSeparator	도구 모음에 구분 기호를 삽입합니다.
CMFCToolBar::InvalidateButton	제공된 인덱스에 있는 도구 모음 단추의 클라이언트 영역을 무효화합니다.
CMFCToolBar::IsAddRemoveQuickCustomize	사용자 지정 메뉴 옵션을 사용하여 사용자가 도구 모음 단추를 추가하거나 제거할 수 있는지 여부를 결정합니다.
CMFCToolBar::IsAltCustomizeMode	빠른 사용자 지정을 사용하여 단추를 끌지 여부를 지정합니다.
CMFCToolBar::IsAutoGrayInactiveImages	비활성(강조 표시되지 않은) 단추 이미지의 자동 생성을 사용할 수 있는지 여부를 지정합니다.
CMFCToolBar::IsBasicCommand	명령이 기본 명령 목록에 있는지 여부를 확인합니다.
CMFCToolBar::IsButtonExtraSizeAvailable	도구 모음에 확장된 테두리가 있는 단추를 표시할 수 있는지 여부를 결정합니다.
CMFCToolBar::IsButtonHighlighted	도구 모음의 단추가 강조 표시되어 있는지 여부를 결정합니다.
CMFCToolBar::IsCommandPermitted	명령이 허용되는지 여부를 확인합니다.
CMFCToolBar::IsCommandRarelyUsed	명령이 거의 사용되지 않는지 여부를 결정합니다(참조 CMFCToolBar::SetCommandUsageOptions).
CMFCToolBar::IsCustomizeMode	도구 모음 프레임워크가 사용자 지정 모드인지 여부를 지정합니다.
CMFCToolBar::IsDragButton	도구 모음 단추를 끌지 여부를 확인합니다.
CMFCToolBar::IsExistCustomizeButton	도구 모음에 사용자 지정 단추가 포함되어 있는지 여부를 확인합니다.
CMFCToolBar::IsFloating	도구 모음이 부동인지 여부를 확인합니다.
CMFCToolBar::IsLargeIcons	애플리케이션의 도구 모음에 현재 큰 아이콘이 표시되는지 여부를 지정합니다.
CMFCToolBar::IsLastCommandFromButton	가장 최근에 실행된 명령이 지정된 도구 모음 단추에서 전송되었는지 여부를 확인합니다.
CMFCToolBar::IsLocked	도구 모음이 잠겨 있는지 여부를 확인합니다.
CMFCToolBar::IsOneRowWithSibling	도구 모음과 해당 형제 도구 모음이 같은 행에 배치되는지 여부를 결정합니다.
CMFCToolBar::IsUserDefined	도구 모음이 사용자 정의인지 여부를 지정합니다.
CMFCToolBar::LoadBitmap	애플리케이션 리소스에서 도구 모음 이미지를 로드합니다.
CMFCToolBar::LoadBitmapEx	애플리케이션 리소스에서 도구 모음 이미지를 로드합니다. 큰 이미지를 포함합니다.
CMFCToolBar::LoadParameters	Windows 레지스트리에서 전역 도구 모음 옵션을 로드합니다.
CMFCToolBar::LoadState	Windows 레지스트리에서 도구 모음 상태 정보를 로드합니다. ( CPane::LoadState을 재정의합니다.)
CMFCToolBar::LoadToolBar	애플리케이션 리소스에서 도구 모음을 로드합니다.
CMFCToolBar::LoadToolBarEx	도우미 클래스를 사용하여 애플리케이션 리소스에서 도구 모음을 CMFCToolBarInfo 로드하여 애플리케이션이 큰 이미지를 사용할 수 있도록 합니다.
CMFCToolBar::OnChangeHot	사용자가 도구 모음에서 단추를 선택할 때 프레임워크에서 호출됩니다.
CMFCToolBar::OnFillBackground	도구 모음 배경을 채우기 위해 프레임워크에서 CBasePane::DoPaint 호출됩니다.
CMFCToolBar::OnReset	도구 모음을 원래 상태로 복원합니다.
CMFCToolBar::OnSetAccData	( CBasePane::OnSetAccData을 재정의합니다.)
CMFCToolBar::OnSetDefaultButtonText	도구 모음 단추의 텍스트를 기본 상태로 복원합니다.
CMFCToolBar::OnUpdateCmdUI	내부적으로 사용됩니다.
CMFCToolBar::RemoveAllButtons	도구 모음에서 모든 단추를 제거합니다.
CMFCToolBar::RemoveButton	도구 모음에서 지정된 인덱스가 있는 단추를 제거합니다.
CMFCToolBar::RemoveStateFromRegistry	Windows 레지스트리에서 도구 모음의 상태 정보를 삭제합니다.
CMFCToolBar::ReplaceButton	도구 모음 단추를 다른 도구 모음 단추로 바꿉니다.
CMFCToolBar::ResetAll	모든 도구 모음을 원래 상태로 복원합니다.
CMFCToolBar::ResetAllImages	애플리케이션의 모든 도구 모음 이미지 컬렉션을 지웁니다.
CMFCToolBar::RestoreOriginalState	도구 모음의 원래 상태를 복원합니다.
CMFCToolBar::SaveState	도구 모음의 상태 정보를 Windows 레지스트리에 저장합니다. ( CPane::SaveState을 재정의합니다.)
CMFCToolBar::Serialize	( CBasePane::Serialize을 재정의합니다.)
CMFCToolBar::SetBasicCommands	사용자가 메뉴를 열 때 항상 표시되는 명령 목록을 설정합니다.
CMFCToolBar::SetButtonInfo	도구 모음 단추의 명령 ID, 스타일 및 이미지 ID를 설정합니다.
CMFCToolBar::SetButtonStyle	지정된 인덱스에서 도구 모음 단추의 스타일을 설정합니다.
CMFCToolBar::SetButtonText	도구 모음 단추의 텍스트 레이블을 설정합니다.
CMFCToolBar::SetButtons	도구 모음의 단추를 설정합니다.
CMFCToolBar::SetCommandUsageOptions	애플리케이션의 메뉴에 거의 사용되지 않는 명령이 표시되지 않는 경우를 지정합니다.
CMFCToolBar::SetCustomizeMode	애플리케이션의 모든 도구 모음에 대해 사용자 지정 모드를 사용하거나 사용하지 않도록 설정합니다.
CMFCToolBar::SetGrayDisabledButtons	도구 모음의 사용 안 함 단추가 흐리게 표시되는지 또는 비활성화된 단추에 사용할 수 없는 이미지를 사용하는지 여부를 지정합니다.
CMFCToolBar::SetHeight	도구 모음의 높이를 설정합니다.
CMFCToolBar::SetHotBorder	도구 모음 단추가 핫 트랙되는지 여부를 지정합니다.
CMFCToolBar::SetHotTextColor	핫 도구 모음 단추의 텍스트 색을 설정합니다.
CMFCToolBar::SetLargeIcons	도구 모음 단추에 큰 아이콘이 표시되는지 여부를 지정합니다.
CMFCToolBar::SetLockedSizes	도구 모음에서 잠긴 단추 및 잠긴 이미지의 크기를 설정합니다.
CMFCToolBar::SetMenuSizes	도구 모음 메뉴 단추 및 해당 이미지의 크기를 설정합니다.
CMFCToolBar::SetNonPermittedCommands	사용자가 실행할 수 없는 명령 목록을 설정합니다.
CMFCToolBar::SetOneRowWithSibling	도구 모음과 해당 형제를 같은 행에 배치합니다.
CMFCToolBar::SetPermament	사용자가 도구 모음을 닫을 수 있는지 여부를 지정합니다.
CMFCToolBar::SetRouteCommandsViaFrame	부모 프레임 또는 소유자가 도구 모음에 명령을 보낼지 여부를 지정합니다.
CMFCToolBar::SetShowTooltips	프레임워크에 도구 팁이 표시되는지 여부를 지정합니다.
CMFCToolBar::SetSiblingToolBar	도구 모음의 형제를 지정합니다.
CMFCToolBar::SetSizes	모든 도구 모음의 단추 및 이미지 크기를 지정합니다.
CMFCToolBar::SetToolBarBtnText	도구 모음에 있는 단추의 속성을 지정합니다.
CMFCToolBar::SetTwoRowsWithSibling	도구 모음과 해당 형제를 별도의 행에 배치합니다.
CMFCToolBar::SetUserImages	애플리케이션에서 사용자 정의 이미지의 컬렉션을 설정합니다.
CMFCToolBar::StretchPane	도구 모음을 세로 또는 가로로 늘입니다. ( CBasePane::StretchPane을 재정의합니다.)
CMFCToolBar::TranslateChar	지정된 키 코드가 유효한 바로 가기 키에 해당하는 경우 단추 명령을 실행합니다.
CMFCToolBar::UpdateButton	지정된 단추의 상태를 업데이트합니다.
CMFCToolBar::WrapToolBar	지정된 차원 내의 도구 모음 단추 위치를 변경합니다.

보호된 메서드

속성	설명
CMFCToolBar::AllowShowOnList	사용자 지정 대화 상자의 도구 모음 창 목록에 도구 모음이 표시되는지 여부를 결정합니다.
CMFCToolBar::CalcMaxButtonHeight	도구 모음에서 단추의 최대 높이를 계산합니다.
CMFCToolBar::DoPaint	도구 모음을 다시 칠합니다.
CMFCToolBar::DrawButton	도구 모음 단추를 다시 칠합니다.
CMFCToolBar::DrawSeparator	도구 모음에 구분 기호를 다시 칠합니다.
CMFCToolBar::OnUserToolTip	단추의 도구 설명이 표시될 때 프레임워크에서 호출됩니다.

데이터 멤버

속성	설명
CMFCToolBar::m_bDontScaleImages	높은 DPI 모드에서 도구 모음 이미지의 크기를 조정할지 여부를 지정합니다.
CMFCToolBar::m_dblLargeImageRatio	큰 이미지의 차원(높이 또는 너비)과 일반 이미지의 차원 사이의 비율을 지정합니다.

설명

애플리케이션에 개체를 CMFCToolBar 통합하려면 다음 단계를 수행합니다.

1. CMFCToolBar 주 프레임 창에 개체를 추가합니다.

2. 주 프레임 창에 대한 WM_CREATE 메시지를 처리할 때 도구 모음을 CMFCToolBar::Create 호출하거나 CMFCToolBar::CreateEx 해당 스타일을 지정합니다.

3. 도킹 스타일을 지정하기 위한 호출 CBasePane::EnableDocking 입니다.

콤보 상자 또는 드롭다운 도구 모음과 같은 특수 단추를 삽입하려면 부모 리소스에 더미 단추를 예약하고 런타임에 더미 단추를 사용하여 CMFCToolBar::ReplaceButton바꿉니다. 자세한 내용은 연습: 도구 모음에 컨트롤 배치를 참조 하세요.

CMFCToolBar는 MFC 라이브러리 클래스 클래스,CMFCPopupMenuBar 클래스 및CMFCDropDownToolBar 클래스의 CMFCMenuBar 기본 클래스입니다.

예시

다음 예제에서는 CMFCToolBar 클래스에서 다양한 메서드를 사용하는 방법을 보여 줍니다. 이 예제에서는 도구 모음의 창 레이블 텍스트를 설정하고, 테두리를 설정하고, 창 스타일을 설정하고, 도구 모음 끝에 나타나는 단추 추가 또는 제거 단추를 사용하도록 설정하는 방법을 보여 줍니다. 이 코드 조각은 IE 데모 샘플의 일부입니다.

CMFCToolBar m_wndToolBar;

m_wndToolBar.SetWindowText(_T("Standard"));
m_wndToolBar.SetBorders();

//------------------------------------
// Remove toolbar gripper and borders:
//------------------------------------
m_wndToolBar.SetPaneStyle(m_wndToolBar.GetPaneStyle() &
                          ~(CBRS_GRIPPER | CBRS_BORDER_TOP | CBRS_BORDER_BOTTOM | CBRS_BORDER_LEFT | CBRS_BORDER_RIGHT));

m_wndToolBar.EnableCustomizeButton(TRUE, ID_VIEW_CUSTOMIZE, _T("Customize..."));

요구 사항

머리글: afxtoolbar.h

상속 계층 구조

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

CMFCToolBar

CMFCToolBar::AddBasicCommand

사용자가 메뉴를 열 때 항상 표시되는 명령 목록에 메뉴 명령을 추가합니다.

static void __stdcall AddBasicCommand(UINT uiCmd);

매개 변수

uiCmd
[in] 추가할 명령을 지정합니다.

설명

기본 명령은 메뉴가 열릴 때 항상 표시됩니다. 이 메서드는 사용자가 최근에 사용한 명령을 보도록 선택할 때 의미가 있습니다.

이 메서드를 CMFCToolBar::SetBasicCommands 사용하여 사용자가 메뉴를 열 때 항상 표시되는 명령 목록을 설정합니다. 이 메서드를 CMFCToolBar::GetBasicCommands 사용하여 애플리케이션에서 사용하는 기본 명령 목록을 검색합니다.

CMFCToolBar::AddCommandUsage

지정된 명령과 연결된 카운터를 하나씩 증분합니다.

static void __stdcall AddCommandUsage(UINT uiCommand);

매개 변수

uiCommand
[in] 증분할 명령 카운터를 지정합니다.

설명

프레임워크는 사용자가 메뉴 항목을 선택할 때 이 메서드를 호출합니다.

프레임워크는 명령 카운터를 사용하여 최근에 사용한 메뉴 항목을 표시합니다.

이 메서드는 메서드를 사용하여 명령 카운터를 CMFCCmdUsageCount::AddCmd 증가합니다.

CMFCToolBar::AddToolBarForImageCollection

사용자 인터페이스 리소스의 이미지를 애플리케이션의 이미지 컬렉션에 추가합니다.

static BOOL __stdcall AddToolBarForImageCollection(
    UINT uiResID,
    UINT uiBmpResID=0,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0);

매개 변수

uiResID
[in] 로드할 이미지가 있는 도구 모음의 리소스 ID입니다.

uiBmpResID
[in] 도구 모음 이미지가 있는 비트맵의 리소스 ID입니다.

uiColdResID
[in] "콜드" 도구 모음 이미지가 있는 비트맵의 리소스 ID입니다.

uiMenuResID
[in] 메뉴 이미지가 있는 비트맵의 리소스 ID입니다.

uiDisabledResID
[in] 사용하지 않도록 설정된 도구 모음 이미지가 있는 비트맵의 리소스 ID입니다.

uiMenuDisabledResID
[in] 비활성화된 메뉴 이미지가 있는 비트맵의 리소스 ID입니다.

Return Value

TRUE 메서드가 성공하면 이고, FALSE uiResID 유효한 리소스를 지정하거나 uiBmpResID 지정하지 않으면 다른 오류가 발생합니다.

설명

이 메서드를 호출하여 도구 모음 이미지를 사용하여 비트맵을 로드하고 도구 모음 이미지 컬렉션에 추가합니다. 이 메서드는 임시 도구 모음 개체를 만들고 호출 CMFCToolBar::LoadToolBar합니다.

CMFCToolBar::AdjustLayout

도구 모음의 크기와 위치를 다시 계산합니다.

virtual void AdjustLayout();

설명

도구 모음을 만들 때 이 메서드를 호출하여 크기와 위치를 다시 계산합니다.

프레임워크는 도구 모음의 레이아웃을 변경해야 할 때마다 이 메서드를 호출합니다. 예를 들어 사용자가 다른 컨트롤 막대를 이동하거나, 애플리케이션 창의 크기를 조정하거나, 도구 모음을 사용자 지정할 때 레이아웃이 변경되어야 합니다.

파생된 클래스에서 고유한 동적 레이아웃을 제공하도록 이 메서드를 재정의 CMFCToolbar합니다.

CMFCToolBar::AdjustSize

도구 모음의 크기를 다시 계산합니다.

void AdjustSize();

설명

이 메서드는 도구 모음이 부모 프레임의 범위에 맞는지 확인합니다. 도구 모음에 부모 프레임이 없는 경우 이 메서드는 아무 작업도 수행하지 않습니다.

이 메서드는 CMFCToolBar::AdjustLayout 도구 모음의 부모가 개체가 아닌 경우 크기를 다시 계산하기 위해 이 메서드를 CMFCReBar 호출합니다.

CMFCToolBar::AllowChangeTextLabels

도구 모음 단추의 이미지 아래에 텍스트 레이블을 표시할 수 있는지 여부를 지정합니다.

virtual BOOL AllowChangeTextLabels() const;

Return Value

TRUE 이미지 아래에 텍스트 레이블을 표시할 수 있으면 이고, 그렇지 않으면 FALSE.

설명

사용자 지정 대화 상자에서 이 메서드를 호출하여 선택한 도구 모음의 도구 모음 페이지에서 텍스트 레이블 표시 확인란을 사용할지 여부를 결정합니다.

기본 구현은 TRUE를 반환합니다.

사용자가 이미지 아래의 도구 모음 단추에 텍스트 레이블이 표시되는지 여부를 결정하지 않으려면 파생된 개체에서 CMFCToolBar 이 메서드를 재정의하고 반환 FALSE 합니다.

CMFCToolBar::AllowShowOnList

사용자 지정 대화 상자의 도구 모음 창에 있는 도구 모음 목록에 도구 모음이 표시되는지 여부를 결정합니다.

virtual BOOL AllowShowOnList() const;

Return Value

TRUE 도구 모음 개체를 도구 모음 사용자 지정 페이지의 목록 상자에 표시할 수 있으면 이고, 그렇지 않으면 FALSE.

설명

이 메서드는 도구 모음 사용자 지정 페이지의 목록에 파생된 특정 개체가 포함되어야 하는지 여부를 결정하기 위해 프레임워크에서 CMFCToolBar호출됩니다.

기본 구현에서는 항상 TRUE을 반환합니다. 사용자 지정 대화 상자의 도구 모음 목록에 도구 모음을 표시하지 않으려면 이 메서드를 재정의합니다.

CMFCToolBar::AreTextLabels

이미지 아래의 텍스트 레이블이 현재 도구 모음 단추에 표시되는지 여부를 지정합니다.

BOOL AreTextLabels() const;

Return Value

TRUE 도구 모음 단추가 이미지 아래에 텍스트 레이블을 표시하면 이고, 그렇지 않으면 FALSE.

설명

텍스트를 표시할지 여부를 지정하는 데 사용합니다 CMFCToolBar::EnableTextLabels . 기본값은 FALSE입니다. 호출 CMFCToolBar::AllowChangeTextLabels 하여 사용자가 사용자 지정 대화 상자에서 이 설정을 변경할 수 있는지 여부를 지정합니다.

CMFCToolBar::AutoGrayInactiveImages

비활성 단추 이미지의 자동 생성을 사용하거나 사용하지 않도록 설정합니다.

static void AutoGrayInactiveImages(
    BOOL bEnable=TRUE,
    int nGrayImagePercentage=0,
    BOOL bRedrawAllToolbars=TRUE);

매개 변수

bEnable
[in] 비활성 이미지를 흐리게 할지 여부를 지정하는 부울 값입니다. 이 매개 변수인 TRUE경우 비활성 이미지가 흐리게 표시됩니다. 그렇지 않으면 비활성 이미지가 흐리게 표시되지 않습니다.

nGrayImagePercentage
[in] 비활성 이미지의 광도 비율을 지정합니다. 이 값이FALSE면 bEnable 무시됩니다.

bRedrawAllToolbars
[in] 애플리케이션의 모든 도구 모음을 다시 그릴지 여부를 지정하는 부울 값입니다. 이 매개 변수인 경우 이 메서드는 TRUE모든 도구 모음을 다시 그어 줍니다.

설명

이 경우 bEnable 프레임워크는 TRUE일반 이미지에서 비활성 이미지를 생성하는 데 사용합니다 nGrayImagePercentage . 그렇지 않으면 메서드를 사용하여 비활성 이미지 집합을 CMFCToolBar::GetColdImages 제공해야 합니다. 기본적으로 이 옵션은 사용하지 않도록 설정되어 있습니다.

매개 변수에 대한 nGrayImagePercentage 자세한 내용은 .를 참조하세요 CMFCToolBarImages::GrayImages.

CMFCToolBar::ButtonToIndex

이 도구 모음에서 지정된 CMFCToolBarButton Class 개체의 인덱스 값을 반환합니다.

int ButtonToIndex(const CMFCToolBarButton* pButton) const;

매개 변수

pButton
[in] 도구 모음 단추 개체에 대한 포인터입니다.

Return Value

도구 모음 단추의 pButton 내부 목록에 있는 인덱스이거나, 지정된 단추가 이 도구 모음에 없으면 -1입니다.

CMFCToolBar::CalcFixedLayout

도구 모음의 가로 크기를 계산합니다.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

매개 변수

bStretch
[in] TRUE 도구 모음을 부모 프레임의 크기로 확장합니다.

bHorz
[in] TRUE 도구 모음의 방향을 가로로 지정합니다. FALSE 도구 모음의 방향을 세로로 지정합니다.

Return Value

CSize 도구 모음의 크기를 지정하는 개체입니다.

설명

이 메서드는 메서드를 사용하여 도구 모음의 크기를 계산합니다 CMFCToolBar::CalcLayout . 매개 변수의 LM_STRETCH 플래그( dwMode 있는 경우 bStretch TRUE)를 전달합니다. 플래그(있는 LM_HORZ 경우 bHorz TRUE)를 전달합니다.

이 메서드를 사용하는 예제는 VisualStudioDemo 샘플을 참조하세요.

CMFCToolBar::CalcMaxButtonHeight

도구 모음에서 단추의 최대 높이를 계산합니다.

virtual int CalcMaxButtonHeight();

Return Value

단추의 최대 높이입니다.

설명

이 메서드는 도구 모음의 모든 도구 모음 단추 중 최대 높이를 계산합니다. 높이는 현재 도구 모음 도킹 상태와 같은 요인에 따라 달라질 수 있습니다.

고유한 높이 계산을 제공하기 위해 파생된 클래스에서 CMFCToolBar 이 메서드를 재정의합니다.

CMFCToolBar::CalcSize

레이아웃 계산 프로세스의 일부로 프레임워크에서 호출됩니다.

virtual CSize CalcSize(BOOL bVertDock);

매개 변수

bVertDock
[in] TRUE 도구 모음이 세로로 도킹되도록 지정하려면 FALSE 도구 모음이 가로로 도킹되도록 지정합니다.

Return Value

CSize 도구 모음에 있는 단추의 전체 크기를 지정하는 개체입니다.

설명

이 메서드는 텍스트 레이블의 영역 및 테두리 크기와 같은 각 단추의 크기에 영향을 주는 특성을 고려합니다.

도구 모음에 단추가 없는 경우 이 메서드는 메서드를 사용하여 CMFCToolBar::GetButtonSize 단일 단추의 예약된 크기를 반환합니다.

CMFCToolBar::CanBeClosed

사용자가 도구 모음을 닫을 수 있는지 여부를 지정합니다.

virtual BOOL CanBeClosed() const;

Return Value

TRUE 사용자가 도구 모음을 닫을 수 있으면 FALSE.

설명

프레임워크는 이 메서드를 호출하여 사용자가 도구 모음을 닫을 수 있는지 여부를 결정합니다. 메서드가 반환 TRUE되면 프레임워크는 도구 모음의 시스템 메뉴에서 명령을 사용하도록 설정하고 SC_CLOSE 사용자는 사용자 지정 대화 상자의 도구 모음 목록에 있는 확인란을 사용하여 도구 모음을 닫을 수 있습니다.

기본 구현은 TRUE를 반환합니다. 사용자가 닫을 수 없는 도구 모음 개체를 만들기 위해 파생된 클래스에서 CMFCToolBar 이 메서드를 재정의합니다.

CMFCToolBar::CanBeRestored

시스템이 사용자 지정 후 도구 모음을 원래 상태로 복원할 수 있는지 여부를 결정합니다.

virtual BOOL CanBeRestored() const;

Return Value

TRUE 애플리케이션 리소스에서 도구 모음을 복원할 수 있으면 이고, 그렇지 않으면 FALSE.

설명

프레임워크는 이 메서드를 호출하여 사용자 지정 후 도구 모음을 원래 상태로 되돌릴 수 있는지 여부를 결정합니다. 원래 상태는 애플리케이션 리소스에서 로드됩니다.

반환TRUE되는 경우 CanBeRestored 사용자 지정 대화 상자의 도구 모음 페이지에서 선택한 도구 모음에 대해 다시 설정 단추를 사용하도록 설정합니다.

기본 구현은 로드될 때 도구 모음의 원래 리소스 ID가 0이 아닌 경우 반환 TRUE 됩니다. 일반적으로 사용자 정의 도구 모음만 복원할 수 없습니다.

메서드를 재정의 CanBeRestored 하여 파생 클래스에서 이 동작을 사용자 지정할 수 있습니다.

CMFCToolBar::CanFocus

창에서 포커스를 받을 수 있는지 여부를 지정합니다.

virtual BOOL CanFocus() const;

Return Value

이 메서드는 FALSE.

설명

도구 모음 개체가 포커스를 받을 수 없으므로 이 메서드는 기본 클래스 구현 CBasePane::CanFocus을 재정의합니다.

CMFCToolBar::CanHandleSiblings

도구 모음 및 해당 형제를 동일한 창에 배치할지를 결정합니다.

BOOL CanHandleSiblings();

Return Value

TRUE 도구 모음에 형제가 있고 도구 모음과 해당 형제가 같은 창에 배치되면 이고, 그렇지 않으면 FALSE.

설명

내부 CMFCCustomizeButton::CreatePopupMenu 메서드는 이 메서드를 호출하여 팝업 사용자 지정 메뉴를 표시하는 방법을 결정합니다. 이 메서드가 반환TRUE되면 프레임워크는 한 행에 단추 표시 또는 두 행 단추의 단추 표시를 표시합니다.

일반적으로 이 메서드를 사용할 필요가 없습니다. 도구 모음에 표시되는 사용자 지정 단추를 사용하도록 설정하려면 메서드를 호출합니다 CMFCToolBar::EnableCustomizeButton . 한 행에 단추 표시 또는 두 행 단추의 단추 표시를 사용하도록 설정하려면 다음을 호출CMFCToolBar::SetSiblingToolBar합니다.

CMFCToolBar::CleanUpImages

도구 모음 이미지에 할당된 시스템 리소스를 해제합니다.

static void CMFCToolBar::CleanUpImages();

설명

프레임워크는 애플리케이션이 종료되면 이 메서드를 호출합니다.

CMFCToolBar::CleanUpLockedImages

잠긴 도구 모음 이미지에 할당된 시스템 리소스를 해제합니다.

void CleanUpLockedImages();

설명

애플리케이션의 비주얼 스타일이 변경되면 이 메서드를 호출합니다. 이 메서드를 사용하는 예제는 VisualStudioDemo 샘플을 참조하세요.

CMFCToolBar::CommandToIndex

지정된 명령 ID를 사용하여 도구 모음에 있는 단추의 인덱스 값을 반환합니다.

int CommandToIndex(
    UINT nIDFind,
    int iIndexFirst=0) const;

매개 변수

nIDFind
[in] 명령 ID를 지정합니다.

iIndexFirst
[in] 시작할 초기 인덱스를 지정합니다.

Return Value

메서드가 성공한 경우 도구 모음 단추의 인덱스(0부터 시작하는 인덱스)입니다. 지정된 ID를 가진 단추가 없으면 -1입니다.

설명

CMFCToolBar 개체는 도구 모음에 있는 단추의 내부 목록을 유지 관리합니다. 이 함수를 호출하여 단추의 명령 ID가 지정된 목록에서 단추의 인덱스 검색

0보다 큰 경우 iIndex 이 메서드는 인덱스가 0보다 iIndex작은 도구 모음의 단추를 무시합니다.

CMFCToolBar::Create

CMFCToolBar 개체를 만듭니다.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    UINT nID=AFX_IDW_TOOLBAR);

매개 변수

pParentWnd
[in] 도구 모음의 부모 창에 대한 포인터입니다.

dwStyle
[in] 도구 모음 스타일입니다. 스타일 목록은 Windows SDK의 도구 모음 컨트롤 및 단추 스타일을 참조하세요.

nID
[in] 도구 모음의 자식 창 ID입니다.

Return Value

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

설명

이 메서드는 컨트롤 막대를 만들고 도구 모음에 연결합니다. TBSTYLE_FLAT 스타일을 사용하여 컨트롤 막대를 만듭니다. 다른 컨트롤 막대 스타일을 원하는 경우 호출 CMFCToolBar::CreateEx 합니다.

CMFCToolBar::CreateEx

CMFCToolBar 큰 아이콘과 같은 추가 스타일 옵션을 사용하는 개체를 만듭니다.

virtual BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle=TBSTYLE_FLAT,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    CRect rcBorders=CRect(1,
    1,
    1,
    1),
    UINT nID=AFX_IDW_TOOLBAR);

매개 변수

pParentWnd
[in] 도구 모음의 부모 창에 대한 포인터입니다.

dwCtrlStyle
[in] 포함된 컨트롤 막대 개체를 만들기 위한 추가 스타일입니다.

dwStyle
[in] 도구 모음 스타일입니다. 적절한 스타일 목록은 도구 모음 컨트롤 및 단추 스타일을 참조하세요.

rcBorders
[in] CRect 도구 모음 창 테두리의 너비를 지정하는 개체입니다.

nID
[in] 도구 모음의 자식 창 ID입니다.

Return Value

이 메서드가 성공하면 0이 아닌 경우 그렇지 않으면 0입니다.

설명

이 메서드는 컨트롤 막대를 만들고 도구 모음에 연결합니다.

특정 스타일을 제공하려는 경우 대신 CMFCToolBar::Create 이 메서드를 호출합니다. 예를 들어 Internet Explorer 4에서 사용하는 도구 모음과 유사한 도구 모음을 만들도록 TBSTYLE_FLAT | TBSTYLE_TRANSPARENT 설정합니다.dwCtrlStyle

예시

다음 예제에서는 클래스의 메서드를 CreateEx 사용 하는 방법을 보여 줍니다 CMFCToolBar . 이 코드 조각은 IE 데모 샘플의 일부입니다.

CMFCToolBar m_wndToolBar;

// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_TRANSPARENT) ||
    !m_wndToolBar.LoadToolBar(IDR_MAINFRAME, uiToolbarColdID, uiMenuID,
                              FALSE /* Not locked */, 0, 0, uiToolbarHotID))
{
   TRACE0("Failed to create toolbar\n");
   return -1; // fail to create
}

CMFCToolBar::Deactivate

도구 모음을 비활성화합니다.

virtual void Deactivate();

설명

이 메서드는 강조 표시된 도구 모음 단추에서 포커스를 제거하여 도구 모음을 비활성화합니다. 프레임워크는 도구 모음이 포커스를 잃거나 제거될 때 이 메서드를 호출합니다.

CMFCToolBar::DoPaint

도구 모음을 다시 칠합니다.

virtual void DoPaint(CDC* pDC);

매개 변수

pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.

설명

이 메서드는 도구 모음의 일부를 다시 그려야 하는 경우 프레임워크에서 호출됩니다.

에서 파생된 CMFCToolBar개체의 모양을 사용자 지정하려면 이 메서드를 재정의합니다.

CMFCToolBar::DrawButton

도구 모음 단추를 다시 칠합니다.

virtual BOOL DrawButton(
    CDC* pDC,
    CMFCToolBarButton* pButton,
    CMFCToolBarImages* pImages,
    BOOL bHighlighted,
    BOOL bDrawDisabledImages);

매개 변수

pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.

pButton
[in] 그릴 단추에 대한 포인터입니다.

pImages
[in] 도구 모음 이미지에 대한 포인터입니다.

bHighlighted
[in] TRUE 단추가 강조 표시되면 이고, 그렇지 않으면 FALSE.

bDrawDisabledImages
[in] TRUE 비활성화된 단추가 흐리게 표시되면 이고, 그렇지 않으면 FALSE.

Return Value

TRUE 단추가 다시 그려졌으면 이고, FALSE 단추를 숨기면 입니다.

설명

이 메서드는 CMFCToolBar::DrawButton 도구 모음 단추를 다시 그려야 하는 경우 이 메서드를 호출합니다.

도구 모음에서 단추의 모양을 사용자 지정하려면 이 메서드를 재정의합니다.

CMFCToolBar::DrawSeparator

도구 모음에 구분 기호를 다시 칠합니다.

virtual void DrawSeparator(
    CDC* pDC,
    const CRect& rect,
    BOOL bHorz);

매개 변수

pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.

rect
[in] 구분 기호가 그려지는 위치의 경계 사각형(픽셀)입니다.

bHorz
[in] TRUE 구분 기호가 가로 FALSE 이면 구분 기호가 세로인 경우

설명

CMFCToolBar::DoPaint는 해당 단추를 호출하는 대신 스타일이 있는 TBBS_SEPARATOR 각 CMFCToolBar::DrawSeparator 개체에 대해 이 메서드를 호출 CMFCToolBar::DrawButton 합니다.

도구 모음에서 구분 기호의 모양을 사용자 지정하기 위해 파생된 클래스에서 CMFCToolBar 이 메서드를 재정의합니다. 기본 구현은 현재 시각적 관리자에 의해 모양이 결정되는 구분 기호를 그리기 위해 호출 CMFCVisualManager::OnDrawSeparator 됩니다.

CMFCToolBar::EnableCustomizeButton

도구 모음에 표시되는 사용자 지정 단추를 사용하거나 사용하지 않도록 설정합니다.

void EnableCustomizeButton(
    BOOL bEnable,
    int iCustomizeCmd,
    const CString& strCustomizeText,
    BOOL bQuickCustomize=TRUE);

void EnableCustomizeButton(
    BOOL bEnable,
    int iCustomizeCmd,
    UINT uiCustomizeTextResId,
    BOOL bQuickCustomize=TRUE);

매개 변수

bEnable
[in] 사용자 지정 단추를 사용하거나 사용하지 않도록 설정합니다.

iCustomizeCmd
[in] 사용자 지정 단추의 명령 ID입니다.

strCustomizeText
[in] 사용자 지정 단추의 텍스트 레이블입니다.

uiCustomizeTextResId
[in] 사용자 지정 단추 레이블의 리소스 문자열 ID입니다.

bQuickCustomize
[in] 단추에서 드롭다운하는 메뉴에서 단추 추가 또는 제거 옵션을 사용하거나 사용하지 않도록 설정합니다.

설명

-1인 경우 여러 도구 모음 단추가 도구 모음 영역에 맞지 않는 경우 iCustomizeCmd 프레임워크에 사용자 지정 단추가 표시됩니다. 단추는 왼쪽을 가리키는 이중 화살표 또는 단추가 더 있음을 나타내는 펼침 단추를 표시합니다.

유효한 명령 ID를 지정하고 bEnable TRUE있는 경우 iCustomizeCmd 사용자 지정 단추가 항상 표시됩니다. 단추에는 작은 아래쪽 화살표가 있고 명령이 포함된 메뉴가 열립니다. 이 명령은 로 지정된 텍스트 레이블을 strCustomizeText사용합니다. 이 경우 bQuickCustomize 메뉴에 단추 추가 또는 제거 옵션이 표시됩니다.TRUE

프레임워크는 지정된 항목 iCustomizeCmd앞에 도구 모음 영역에 맞지 않는 단추를 메뉴에 동적으로 추가합니다. 아래쪽 화살표 옆에 펼침 단추가 표시됩니다.

CMFCToolBar::EnableDocking

창을 주 프레임에 도킹할 수 있습니다.

virtual void EnableDocking(DWORD dwAlignment);

매개 변수

dwAlignment
[in] 사용하도록 설정할 도킹 맞춤을 지정합니다.

설명

이 메서드는 데이터 멤버를 .로 설정하여 기본 클래스 구현 CBasePane::EnableDocking을 CBasePane::m_dwControlBarStyle 확장합니다 AFX_CBRS_FLOAT. 그런 다음 이 메서드는 기본 클래스 구현에 전달됩니다 dwAlignment .

CMFCToolBar::EnableLargeIcons

도구 모음 단추에서 큰 아이콘을 사용하거나 사용하지 않도록 설정합니다.

void EnableLargeIcons(BOOL bEnable);

매개 변수

bEnable
[in] TRUE 큰 아이콘을 FALSE 사용하도록 설정하려면 큰 아이콘을 사용하지 않도록 설정합니다.

설명

기본적으로 큰 아이콘이 사용됩니다.

CMFCToolBar::EnableQuickCustomization

사용자가 Alt 키를 누르고 단추를 새 위치로 끌 수 있도록 도구 모음의 빠른 사용자 지정을 사용하거나 사용하지 않도록 설정합니다.

static void EnableQuickCustomization(BOOL bEnable=TRUE);

매개 변수

bEnable
[in] TRUE 빠른 사용자 지정을 사용하도록 설정하려면 빠른 사용자 FALSE 지정을 사용하지 않도록 설정합니다.

CMFCToolBar::EnableReflections

명령 리플렉션을 사용하거나 사용하지 않도록 설정합니다.

void EnableReflections(BOOL bEnable = TRUE);

매개 변수

bEnable
[in] TRUE 명령 리플렉션을 사용하도록 설정하려면 다음을 실행합니다. FALSE 명령 리플렉션을 사용하지 않도록 설정합니다.

설명

콤보 상자와 같은 포함된 컨트롤이 포함된 도구 모음 단추에 명령 리플렉션을 사용하도록 설정하려면 이 메서드를 호출합니다.

명령 리플렉션 에 대한 자세한 내용은 TN062: Windows 컨트롤용 메시지 리플렉션을 참조하세요.

CMFCToolBar::EnableTextLabels

도구 모음 단추 이미지에서 텍스트 레이블을 사용하거나 사용하지 않도록 설정합니다.

void EnableTextLabels(BOOL bEnable=TRUE);

매개 변수

bEnable
TRUE 도구 모음 단추 이미지 아래에 텍스트 레이블이 표시되면 이고, 그렇지 않으면 FALSE.

설명

텍스트 레이블을 사용하도록 설정하면 도구 모음의 모든 단추가 확대되어 이미지 아래에 레이블이 표시될 공간을 제공합니다. 사용자 지정 대화 상자에는 도구 모음 페이지에 텍스트 레이블 표시 확인란이 있습니다 . 사용자가 도구 모음을 선택하고 이 옵션을 확인하면 프레임워크는 선택한 도구 모음을 호출 EnableTextLabels 합니다. 에서 반환하여 파생된 CMFCToolBar 개체에 대한 확인란을 사용하지 않도록 설정할 수 있습니다 FALSE CMFCToolBar::AllowChangeTextLabels .

CMFCToolBar::FromHandlePermanent

지정된 창 핸들이 포함된 개체에 CMFCToolBar 대한 포인터를 검색합니다.

static CMFCToolBar* __stdcall FromHandlePermanent(HWND hwnd);

매개 변수

hwnd
[in] 찾을 창 핸들입니다.

Return Value

지정된 창 핸들 NULL 이 CMFCToolBar 들어 있거나 해당 CMFCToolBar 개체가 없는 경우 개체에 대한 포인터입니다.

설명

이 공유 메서드는 지정된 창 핸들이 포함된 개체에 대해 애플리케이션의 CMFCToolBar 각 도구 모음을 검사합니다.

CMFCToolBar::GetAllButtons

도구 모음에 있는 단추의 읽기 전용 목록을 반환합니다.

const CObList& GetAllButtons() const;

Return Value

클래스 개체의 CObList 컬렉션을 CMFCToolBarButton 포함하는 Class 개체에 대한 상수 참조입니다.

CMFCToolBar::GetAllToolbars

애플리케이션에 있는 모든 도구 모음의 읽기 전용 목록을 반환합니다.

static const CObList& GetAllToolbars();

Return Value

개체 컬렉션을 CMFCToolBar 포함하는 Class 개체에 대한 const 참조 CObList 입니다.

CMFCToolBar::GetBasicCommands

애플리케이션에 정의된 기본 명령의 읽기 전용 목록을 반환합니다.

static const CList<UINT,UINT>& GetBasicCommands();

Return Value

기본 명령 컬렉션이 포함된 Class 개체에 대한 const 참조 CList 입니다.

설명

호출 CMFCToolBar::AddBasicCommand 또는 CMFCToolBar::SetBasicCommands.을 사용하여 기본 명령을 추가합니다.

CMFCToolBar::GetButton

지정된 인덱스에서 Class 개체에 CMFCToolBarButton 대한 포인터를 반환합니다.

CMFCToolBarButton* GetButton(int iIndex) const;

매개 변수

iIndex
[in] 반환할 단추의 인덱스를 지정합니다.

Return Value

도구 모음 단추가 있는 경우 도구 모음 단추에 대한 포인터입니다. 또는 NULL 이러한 단추가 없는 경우

CMFCToolBar::GetButtonInfo

지정된 인덱스에서 단추의 명령 ID, 스타일 및 이미지 인덱스 값을 반환합니다.

void GetButtonInfo(
    int nIndex,
    UINT& nID,
    UINT& nStyle,
    int& iImage) const;

매개 변수

nIndex
[in] 도구 모음의 단추 목록에 있는 단추의 인덱스를 지정합니다.

nID
[out] 단추의 명령 ID입니다.

nStyle
[out] 단추의 스타일입니다.

iImage
[out] 단추에 대한 이미지의 인덱스입니다.

설명

메서드는 GetButtonInfo 지정된 인덱스에서 도구 모음 단추를 찾고 단추의 명령 ID, 스타일 및 이미지 인덱스를 검색합니다.

지정된 인덱스 단추가 없으면 프레임워크가 0으로 설정되고 iImage 메서드가 반환될 때 -1로 설정 nID nStyle 됩니다.

CMFCToolBar::GetButtonSize

도구 모음에서 각 단추의 크기를 반환합니다.

CSize GetButtonSize() const;

Return Value

CSize 도구 모음에서 각 단추의 크기를 지정하는 Class 개체입니다.

설명

도구 모음에서 각 단추의 크기를 호출 CMFCToolBar::SetSizes 하거나 CMFCToolBar::SetLockedSizes 설정합니다.

CMFCToolBar::GetButtonStyle

지정된 인덱스 위치에 있는 도구 모음 단추의 현재 스타일을 반환합니다.

UINT GetButtonStyle(int nIndex) const;

매개 변수

nIndex
[in] 도구 모음 단추의 인덱스를 지정합니다.

Return Value

도구 모음 단추의 스타일을 지정하는 값입니다. . 가능한 스타일 목록은 도구 모음 컨트롤 스타일을 참조하세요.

설명

도구 모음 단추의 스타일을 설정하기 위한 호출 CMFCToolBar::SetButtonStyle

CMFCToolBar::GetButtonText

지정된 인덱스가 있는 단추의 텍스트 레이블을 반환합니다.

CString GetButtonText(int nIndex) const;

void GetButtonText(
    int nIndex,
    CString& rString) const;

매개 변수

nIndex
[in] 도구 모음 단추의 인덱스입니다.

rString
[out] 도구 모음 단추의 레이블 텍스트입니다.

Return Value

도구 모음 단추의 레이블 텍스트입니다.

설명

텍스트 레이블을 호출 CMFCToolBar::SetButtonText 하거나 CMFCToolBar::SetToolBarBtnText 설정합니다.

CMFCToolBar::GetColdImages

애플리케이션의 콜드 도구 모음 단추 이미지 컬렉션에 대한 포인터를 반환합니다.

static CMFCToolBarImages* GetColdImages();

Return Value

콜드 도구 모음 단추 이미지 컬렉션에 대한 포인터입니다.

설명

콜드 이미지는 사용자가 도구 모음 단추와 상호 작용하지 않을 때 사용되는 이미지입니다. 콜드 이미지를 호출 CMFCToolBar::LoadBitmapEx 하거나 CMFCToolBar::LoadBitmap 로드합니다.

CMFCToolBar::GetColumnWidth

도구 모음 단추의 너비를 반환합니다.

virtual int GetColumnWidth() const;

Return Value

도구 모음 단추의 너비를 지정하는 값입니다.

설명

프레임워크는 이 메서드를 호출하여 도구 모음 레이아웃을 계산합니다. 파생 클래스에서 이 메서드를 재정의하여 도구 모음에 다른 열 너비를 지정합니다.

CMFCToolBar::GetCommandButtons

애플리케이션의 모든 도구 모음에서 지정된 명령 ID가 있는 단추 목록을 반환합니다.

static int GetCommandButtons(
    UINT uiCmd,
    CObList& listButtons);

매개 변수

uiCmd
[in] 단추의 명령 ID입니다.

listButtons
[out] 도구 모음 단추 목록을 받는 Class 개체에 대한 참조 CObList 입니다.

Return Value

지정된 명령 ID가 있는 단추의 수입니다.

CMFCToolBar::GetCount

도구 모음의 단추 및 구분 기호 수를 반환합니다.

int GetCount() const;

Return Value

도구 모음의 단추 및 구분 기호 수입니다.

CMFCToolBar::GetCustomizeButton

도구 모음과 연결된 개체에 CMFCCustomizeButton 대한 포인터를 검색합니다.

CMFCCustomizeButton* GetCustomizeButton();

Return Value

도구 모음과 연결된 개체에 대한 포인터 CMFCCustomizeButton 입니다.

설명

이 메서드는 도구 모음의 끝에 나타나는 사용자 지정 단추를 검색합니다. 이 메서드를 CMFCToolBar::EnableCustomizeButton 사용하여 도구 모음에 사용자 지정 단추를 추가합니다.

메서드를 CMFCToolBar::IsExistCustomizeButton 호출하여 도구 모음에 유효한 CMFCCustomizeButton 개체가 포함되어 있는지 여부를 확인할 수 있습니다.

CMFCToolBar::GetDefaultImage

지정된 명령 ID를 사용하여 도구 모음 단추에 대한 기본 이미지의 인덱스 값을 반환합니다.

static int GetDefaultImage(UINT uiID);

매개 변수

uiID
[in] 단추의 명령 ID를 지정합니다.

Return Value

이미지의 공유 목록에 있는 도구 모음 이미지의 인덱스입니다.

설명

이 공유 메서드를 사용하여 지정된 명령 ID를 사용하여 도구 모음 단추의 기본 이미지 인덱스 검색 반환 값은 애플리케이션의 모든 도구 모음에 대한 도구 모음 단추 이미지의 공유 컬렉션에 대한 인덱스입니다. 메서드를 CMFCToolBar::GetImages 호출하여 이 컬렉션에 대한 포인터를 가져옵니다.

CMFCToolBar::GetDisabledImages

애플리케이션에서 사용하지 않도록 설정된 도구 모음 단추에 사용되는 이미지 컬렉션에 대한 포인터를 반환합니다.

static CMFCToolBarImages* __stdcall GetDisabledImages();

Return Value

사용하지 않도록 설정된 도구 모음 단추 이미지 컬렉션에 대한 포인터입니다.

설명

클래스 및 CMFCToolBar::LoadBitmap 메서드를 사용하여 비활성화된 CMFCToolBarEditBoxButton 도구 모음 단추 이미지를 로드합니다.

CMFCToolBar::GetDisabledMenuImages

애플리케이션에서 비활성화된 메뉴 단추에 사용되는 이미지 컬렉션에 대한 포인터를 반환합니다.

static CMFCToolBarImages* __stdcall GetDisabledMenuImages();

Return Value

비활성화된 메뉴 이미지 컬렉션에 대한 포인터입니다.

설명

클래스 메서드를 사용하여 비활성화된 이미지를 로드합니다.CMFCToolBarEditBoxButton

CMFCToolBar::GetDroppedDownMenu

현재 하위 메뉴를 표시하는 메뉴 단추 개체에 대한 포인터를 검색합니다.

CMFCToolBarMenuButton* GetDroppedDownMenu(int* pIndex = NULL) const;

매개 변수

pIndex
[out] 도구 모음 단추 컬렉션에서 단추의 인덱스를 받습니다.

Return Value

하위 메뉴를 표시하거나 NULL 하위 메뉴를 표시하는 메뉴가 없는 경우 메뉴 단추 개체에 대한 포인터입니다.

설명

이 메서드가 null이 아닌 값을 반환하지 pIndex 않으면 NULL가리키는 값 pIndex 이 도구 모음 단추 컬렉션의 메뉴 단추 인덱스로 설정됩니다.

CMFCToolBar::GetGrayDisabledButtons

비활성화된 단추의 이미지가 일반 단추 이미지의 흐리게 표시된 버전인지 또는 비활성화된 단추 이미지 컬렉션에서 가져온 것인지를 지정합니다.

BOOL GetGrayDisabledButtons() const;

Return Value

TRUE 비활성화된 단추의 이미지를 흐리게 표시하려면 FALSE 사용할 수 없는 이미지 컬렉션에서 이미지를 가져옵니다.

설명

흐리게 표시된 이미지와 비활성화된 이미지 컬렉션의 이미지 간에 전환하는 데 사용합니다 CMFCToolBar::SetGrayDisabledButtons .

CMFCToolBar::GetHighlightedButton

현재 강조 표시된 도구 모음 단추에 대한 포인터를 반환합니다.

CMFCToolBarButton* GetHighlightedButton() const;

Return Value

도구 모음 단추 개체에 대한 포인터입니다. 또는 NULL 단추가 강조 표시되지 않는 경우

설명

키보드 포커스가 있는 경우 도구 모음 단추가 강조 표시됩니다. 도구 모음 단추가 이 응용 프로그램에서 핫 트랙(자세한 내용은 참조 CMFCToolBar::GetHotBorder 및 CMFCToolBar::SetHotBorder참조)이고 도구 모음 단추 또는 메뉴 항목에 키보드 포커스가 없을 때 마우스가 도구 모음 단추를 가리키는 경우에도 도구 모음 단추가 강조 표시됩니다.

CMFCToolBar::GetHotBorder

도구 모음 단추가 핫 트랙되는지 여부를 확인합니다. 단추가 핫 트랙인 경우 마우스가 단추를 가로질러 이동할 때 강조 표시됩니다.

BOOL GetHotBorder() const;

Return Value

TRUE도구 모음 단추가 핫 추적되면 이고, 그렇지 않으면 . FALSE

설명

기본적으로 도구 모음 단추는 핫 추적됩니다.

CMFCToolBar::GetHotTextColor

강조 표시된 도구 모음 단추의 텍스트 색을 반환합니다.

static COLORREF GetHotTextColor();

Return Value

COLORREF 현재 강조 표시된 텍스트 색을 나타내는 값입니다.

설명

강조 표시된 도구 모음 단추에 대한 새 텍스트 색을 설정하려면 호출 CMFCToolBar::SetHotTextColor 합니다.

CMFCToolBar::GetHwndLastFocus

도구 모음이 실행되기 직전에 입력 포커스가 있는 창에 핸들을 반환합니다.

HWND GetHwndLastFocus() const;

Return Value

이전에 입력 포커스가 있었던 클래스에서 CMFCBaseToolBar 파생되지 않은 창에 대한 핸들이거나 NULL 이러한 창이 없는 경우

설명

컨트롤이 CMFCToolBar 입력 포커스를 받으면 나중에 복원할 수 있도록 포커스가 손실된 창에 핸들을 저장합니다.

CMFCToolBar::GetIgnoreSetText

단추 레이블을 설정하는 호출이 무시되는지 여부를 지정합니다.

BOOL GetIgnoreSetText() const;

Return Value

TRUE단추 레이블을 설정하는 호출이 무시되면 이고, 그렇지 않으면 . FALSE

설명

CMFCToolBar::GetImages

애플리케이션의 기본 단추 이미지 컬렉션에 대한 포인터를 반환합니다.

static CMFCToolBarImages* GetImages();

Return Value

애플리케이션의 모든 도구 모음에 CMFCToolBarImages 대한 기본 이미지 컬렉션을 포함하는 Class 개체에 대한 포인터입니다.

설명

이 공유 메서드는 애플리케이션에 대한 모든 기본 도구 모음 이미지 컬렉션에 대한 액세스를 제공합니다. 메서드를 CMFCToolBar::LoadBitmap 호출하여 컬렉션에 이미지를 추가합니다.

CMFCToolBar::GetImageSize

도구 모음 단추 이미지의 현재 크기를 반환합니다.

CSize GetImageSize() const;

Return Value

CSize 도구 모음 단추 이미지의 현재 크기를 나타내는 Class 개체입니다.

CMFCToolBar::GetImagesOffset

도구 모음 단추 이미지의 전역 목록에서 이 도구 모음의 도구 모음 단추 이미지를 찾는 데 사용되는 인덱스 오프셋을 반환합니다.

int GetImagesOffset() const;

Return Value

도구 모음 이미지의 인덱스 오프셋입니다.

설명

모든 도구 모음 기본 이미지는 전역 CMFCToolBarImages 클래스 목록에 저장됩니다. 도구 모음의 각 단추에 대한 이미지는 해당 목록에 연속적으로 저장됩니다. 이미지의 인덱스 계산을 위해 도구 모음에 있는 단추의 인덱스가 해당 도구 모음 단추에 대한 이미지 목록의 시작 부분 오프셋에 추가됩니다.

단추에 대한 포인터가 지정된 도구 모음 단추의 인덱스 가져오기를 호출 CMFCToolBar::ButtonToIndex 합니다.

도구 모음 이미지 컬렉션에 대한 포인터를 가져오려면 호출 CMFCToolBar::GetImages 합니다.

CMFCToolBar::GetInvalidateItemRect

지정된 인덱스의 단추에 대해 다시 그려야 하는 클라이언트 영역의 영역을 검색합니다.

virtual void GetInvalidateItemRect(
    int nIndex,
    LPRECT lpRect) const;

매개 변수

nIndex
[in] 클라이언트 영역을 검색할 단추의 인덱스입니다.

lpRect
[out] 클라이언트 영역의 영역을 수신하는 개체에 대한 포인터 RECT 입니다.

설명

매개 변수는 .이 lpRect 아니어야 NULL합니다. 제공된 인덱 lpRect 스에 단추가 없으면 0으로 RECT 초기화된 개체를 받습니다.

CMFCToolBar::GetItemID

지정된 인덱스에서 도구 모음 단추의 명령 ID를 반환합니다.

UINT GetItemID(int nIndex) const;

매개 변수

nIndex
[in] 도구 모음 단추의 인덱스를 지정합니다.

Return Value

도구 모음 단추의 명령 ID입니다. 지정한 인덱스가 있는 단추가 없으면 0입니다.

CMFCToolBar::GetItemRect

지정된 인덱스에서 단추의 경계 사각형을 반환합니다.

virtual void GetItemRect(
    int nIndex,
    LPRECT lpRect) const;

매개 변수

nIndex
[in] 도구 모음 단추의 인덱스를 지정합니다.

lpRect
[out] 이미지 경계 사각형의 좌표를 받는 개체에 대한 포인터 CRect 입니다.

설명

CRect 지정한 lpRect 인덱스에서 단추가 없으면 점이 0으로 설정된 개체입니다.

예시

다음 예제에서는 클래스의 메서드를 GetItemRect 사용 하는 방법을 보여 줍니다 CMFCToolBar . 이 코드 조각은 IE 데모 샘플의 일부입니다.

CMFCToolBar m_wndToolBar;

CRect rectToolBar;
m_wndToolBar.GetItemRect(0, &rectToolBar);

CMFCToolBar::GetLargeColdImages

애플리케이션의 큰 콜드 도구 모음 단추 이미지 컬렉션에 대한 포인터를 반환합니다.

static CMFCToolBarImages* GetLargeColdImages();

Return Value

큰 콜드 이미지 컬렉션에 대한 포인터입니다.

설명

콜드 이미지는 사용자가 도구 모음 단추와 상호 작용하지 않을 때 사용되는 이미지입니다. 큰 콜드 이미지를 로드하려면 호출 CMFCToolBar::LoadBitmapEx 합니다.

CMFCToolBar::GetLargeDisabledImages

애플리케이션에서 사용하지 않도록 설정된 큰 도구 모음 단추 이미지 컬렉션에 대한 포인터를 반환합니다.

static CMFCToolBarImages* GetLargeDisabledImages();

Return Value

사용하지 않도록 설정된 큰 도구 모음 단추 이미지 컬렉션에 대한 포인터입니다.

설명

큰 이미지는 일반 도구 모음 단추 이미지의 큰 버전입니다. 큰 이미지를 호출 CMFCToolBar::LoadBitmapEx 하거나 CMFCToolBar::LoadBitmap 로드합니다.

CMFCToolBar::GetLargeImages

애플리케이션의 큰 도구 모음 단추 이미지 컬렉션에 대한 포인터를 반환합니다.

static CMFCToolBarImages* GetLargeImages();

Return Value

큰 도구 모음 단추 이미지 컬렉션에 대한 포인터입니다.

설명

큰 이미지는 일반 도구 모음 단추 이미지의 큰 버전입니다. 큰 이미지를 로드하기 위한 호출 CMFCToolBar::LoadBitmapEx 입니다.

CMFCToolBar::GetLockedColdImages

도구 모음에서 잠긴 콜드 이미지 컬렉션에 대한 포인터를 반환합니다.

CMFCToolBarImages* GetLockedColdImages();

Return Value

잠긴 콜드 이미지 NULL 컬렉션 또는 도구 모음이 잠겨 있지 않은 경우의 포인터입니다.

설명

잠긴 이미지는 사용자가 도구 모음을 사용자 지정할 수 없을 때 프레임워크에서 사용하는 일반 도구 모음 단추 이미지의 버전입니다. 콜드 이미지는 사용자가 도구 모음 단추와 상호 작용하지 않을 때 사용되는 이미지입니다.

이 메서드는 도구 모음이 잠겨 있지 않으면 반환 NULL 합니다. 또한 이 메서드는 도구 모음이 잠겨 있지 않은 경우 디버그 빌드에서 어설션 오류를 생성합니다. 잠긴 도구 모음에 대한 자세한 내용은 다음을 참조하세요 CMFCToolBar::IsLocked.

메서드를 CMFCToolBar::LoadBitmapEx 호출하여 잠긴 콜드 이미지를 로드합니다.

CMFCToolBar::GetLockedDisabledImages

도구 모음에서 잠긴 비활성화된 이미지 컬렉션에 대한 포인터를 반환합니다.

CMFCToolBarImages* GetLockedDisabledImages();

Return Value

잠긴 비활성화된 이미지 컬렉션에 대한 포인터이거나 NULL 도구 모음이 잠겨 있지 않은 경우

설명

잠긴 이미지는 사용자가 도구 모음을 사용자 지정할 수 없을 때 프레임워크에서 사용하는 일반 도구 모음 단추 이미지의 버전입니다. 비활성화된 이미지는 단추에 스타일이 있을 때 프레임워크에서 사용하는 이미지입니다 TBBS_DISABLED .

이 메서드는 도구 모음이 잠겨 있지 않으면 반환 NULL 합니다. 또한 이 메서드는 도구 모음이 잠겨 있지 않은 경우 디버그 빌드에서 어설션 오류를 생성합니다. 잠긴 도구 모음에 대한 자세한 내용은 다음을 참조하세요 CMFCToolBar::IsLocked.

메서드를 CMFCToolBar::LoadBitmapEx 호출하여 잠긴 비활성화된 이미지를 로드합니다.

CMFCToolBar::GetLockedImages

도구 모음에서 잠긴 단추 이미지 컬렉션에 대한 포인터를 반환합니다.

CMFCToolBarImages* GetLockedImages();

Return Value

잠긴 도구 모음 단추 이미지 컬렉션에 대한 포인터이거나 NULL 도구 모음이 잠겨 있지 않은 경우

설명

잠긴 이미지는 사용자가 도구 모음을 사용자 지정할 수 없을 때 프레임워크에서 사용하는 일반 도구 모음 단추 이미지의 버전입니다.

이 메서드는 도구 모음이 잠겨 있지 않으면 반환 NULL 합니다. 또한 이 메서드는 도구 모음이 잠겨 있지 않은 경우 디버그 빌드에서 어설션 오류를 생성합니다. 잠긴 도구 모음에 대한 자세한 내용은 다음을 참조하세요 CMFCToolBar::IsLocked.

CMFCToolBar::GetLockedImageSize

잠긴 도구 모음 이미지의 기본 크기를 반환합니다.

CSize GetLockedImageSize() const;

Return Value

CSize 잠긴 도구 모음 이미지의 크기를 지정하는 구조체이거나 도구 모음이 잠겨 있지 않은 경우 빈 CSize 구조체입니다.

설명

잠긴 이미지는 사용자가 도구 모음을 사용자 지정할 수 없을 때 프레임워크에서 사용하는 일반 도구 모음 단추 이미지의 버전입니다.

이 메서드는 도구 모음이 CSize 잠겨 있지 않으면 너비가 0이고 높이가 0인 구조를 반환합니다. 또한 이 메서드는 도구 모음이 잠겨 있지 않은 경우 디버그 빌드에서 어설션 오류를 생성합니다. 잠긴 도구 모음에 대한 자세한 내용은 다음을 참조하세요 CMFCToolBar::IsLocked.

메서드를 CMFCToolBar::SetLockedSizes 호출하여 잠긴 이미지 크기를 지정합니다.

CMFCToolBar::GetLockedMenuImages

도구 모음의 잠긴 도구 모음 메뉴 이미지 컬렉션에 대한 포인터를 반환합니다.

CMFCToolBarImages* GetLockedMenuImages();

Return Value

잠긴 도구 모음 메뉴 이미지 컬렉션에 대한 포인터이거나 NULL 도구 모음이 잠겨 있지 않은 경우

설명

잠긴 이미지는 사용자가 도구 모음을 사용자 지정할 수 없을 때 프레임워크에서 사용하는 일반 도구 모음 메뉴 이미지의 버전입니다.

이 메서드는 도구 모음이 잠겨 있지 않으면 반환 NULL 합니다. 또한 이 메서드는 도구 모음이 잠겨 있지 않은 경우 디버그 빌드에서 어설션 오류를 생성합니다. 잠긴 도구 모음에 대한 자세한 내용은 다음을 참조하세요 CMFCToolBar::IsLocked.

메서드를 CMFCToolBar::LoadBitmapEx 호출하여 잠긴 메뉴 이미지를 로드합니다.

CMFCToolBar::GetMenuButtonSize

애플리케이션의 메뉴 단추 크기를 반환합니다.

static CSize GetMenuButtonSize();

Return Value

CSize 메뉴 단추의 크기를 픽셀 단위로 나타내는 개체입니다.

설명

도구 모음의 메뉴 단추 크기는 전역 변수로 유지 관리되며 이 정적 메서드를 통해 검색할 수 있습니다.

이 전역 변수를 설정하기 위한 호출 CMFCToolBar::SetMenuSizes 입니다.

CMFCToolBar::GetMenuImages

애플리케이션의 메뉴 단추 이미지 컬렉션에 대한 포인터를 반환합니다.

static CMFCToolBarImages* GetMenuImages();

Return Value

메뉴 이미지 컬렉션에 대한 포인터입니다.

설명

메서드를 CMFCToolBar::LoadBitmapEx 호출하여 메뉴 이미지를 로드합니다.

메서드를 CMFCToolBar::SetMenuSizes 호출하여 단추 및 해당 이미지의 크기를 설정합니다.

CMFCToolBar::GetMenuImageSize

애플리케이션의 메뉴 단추 이미지 크기를 반환합니다.

static CSize GetMenuImageSize();

Return Value

CSize 메뉴 이미지의 크기를 나타내는 개체입니다.

설명

이 메서드는 전역 변수로 유지 관리되는 도구 모음 메뉴 단추의 이미지 크기를 반환합니다. 이 전역 변수를 설정하기 위한 호출 CMFCToolBar::SetMenuSizes 입니다.

CMFCToolBar::GetOrigButtons

도구 모음의 사용자 지정되지 않은 단추 컬렉션을 검색합니다.

const CObList& GetOrigButtons() const;

Return Value

도구 모음의 사용자 지정되지 않은 단추 목록에 대한 참조입니다.

설명

프레임워크는 사용자가 사용자 지정하기 전에 도구 모음 단추의 복사본을 만듭니다. 메서드는 CMFCToolBar::SetButtons 제공된 배열의 각 단추 복사본을 원래 단추 목록에 추가합니다. 메서드는 CMFCToolBar::RestoreOriginalState 리소스 파일에서 로드하여 도구 모음의 원래 상태를 복원합니다.

도구 모음의 원래 단추 목록을 설정하려면 메서드를 호출합니다 CMFCToolBar::SetOrigButtons .

CMFCToolBar::GetOrigResetButtons

도구 모음의 사용자 지정되지 않은 재설정 단추 컬렉션을 검색합니다.

const CObList& GetOrigResetButtons() const;

Return Value

도구 모음의 사용자 지정되지 않은 재설정 단추 목록에 대한 참조입니다.

설명

사용자가 사용자 지정 모드 중에 다시 설정 단추를 선택하면 프레임워크는 이 메서드를 사용하여 도구 모음에서 제거된 단추를 복원합니다.

메서드는 CMFCToolBar::SetButtons 메서드를 호출한 후 원래 다시 설정 단추 목록에 각 도구 모음 단추의 복사본을 CMFCToolBar::OnReset 추가합니다. 사용자가 다시 설정 단추를 누른 후 단추의 모양을 사용자 지정 하는 메서드를 재정 CMFCToolBar::OnReset 의할 수 있습니다.

CMFCToolBar::GetResourceID

도구 모음의 리소스 ID를 검색합니다.

UINT GetResourceID() const;

Return Value

도구 모음의 리소스 ID입니다.

설명

메서드를 CMFCToolBar::LoadToolBarEx 호출하여 도구 모음의 리소스 ID를 설정합니다.

CMFCToolBar::GetRouteCommandsViaFrame

도구 모음에 명령을 보내는 개체, 부모 프레임 또는 소유자를 결정합니다.

BOOL GetRouteCommandsViaFrame();

Return Value

부모 프레임이 도구 모음에 명령을 보내는 경우 0이 아닌 경우 소유자가 도구 모음에 명령을 보내는 경우 0입니다.

설명

기본적으로 부모 프레임은 도구 모음에 명령을 보냅니다. 이 동작을 변경하려면 호출 CMFCToolBar::SetRouteCommandsViaFrame 합니다.

이 메서드가 0이 아닌 값을 반환하는 경우 메서드를 사용하여 부모 프레임 개체에 대한 포인터를 CMFCToolBar::GetCommandTarget 검색할 수 있습니다. 이 메서드를 사용하는 예제는 VisualStudioDemo 샘플을 참조하세요.

CMFCToolBar::GetRowHeight

도구 모음 단추의 높이를 반환합니다.

virtual int GetRowHeight() const;

Return Value

도구 모음 단추의 높이(픽셀)입니다.

설명

프레임워크는 이 메서드를 호출하여 도구 모음 레이아웃을 계산합니다. 파생 클래스에서 이 메서드를 재정의하여 도구 모음에 다른 높이를 지정합니다.

CMFCToolBar::GetShowTooltips

도구 모음 단추에 대한 도구 팁을 표시할지 여부를 지정합니다.

static BOOL GetShowTooltips();

Return Value

TRUE 도구 모음 단추에 대한 도구 팁이 표시되면 이고, 그렇지 않으면 FALSE.

설명

기본적으로 도구 팁이 표시됩니다. 를 호출 CMFCToolBar::SetShowTooltips하여 이 정적 플래그를 변경할 수 있습니다.

CMFCToolBar::GetSiblingToolBar

도구 모음의 형제를 검색합니다.

CMFCToolBar* GetSiblingToolBar();

Return Value

형제 도구 모음에 대한 포인터입니다.

설명

한 행에 단추 표시 및 두 행 단추의 단추 표시를 사용하도록 설정하는 방법에 대한 자세한 내용은 다음을 참조하세요CMFCToolBar::SetSiblingToolBar.

CMFCToolBar::GetUserImages

애플리케이션에서 사용자 정의 도구 모음 단추 이미지 컬렉션에 대한 포인터를 반환합니다.

static CMFCToolBarImages* GetUserImages();

Return Value

애플리케이션의 모든 도구 모음에 대한 사용자 정의 도구 모음 단추 이미지 컬렉션에 대한 포인터입니다.

설명

메서드를 CMFCToolBar::SetUserImages 호출하여 애플리케이션에서 사용자 정의 이미지 컬렉션을 설정합니다.

CMFCToolBar::HitTest

지정된 위치에 있는 도구 모음 단추의 인덱스 값을 반환합니다.

virtual int HitTest(CPoint point);

매개 변수

point
[in] 클라이언트 좌표에서 테스트할 지점입니다.

Return Value

지정된 위치에 있는 단추의 인덱스이거나, 단추가 없거나 단추가 구분 기호인 경우 -1입니다.

CMFCToolBar::InsertButton

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

virtual int InsertButton(
    const CMFCToolBarButton& button,
    INT_PTR iInsertAt=-1);

virtual int InsertButton(
    CMFCToolBarButton* pButton,
    int iInsertAt=-1);

매개 변수

button
[in] 삽입할 단추를 지정합니다.

iInsertAt
[in] 단추를 삽입할 0부터 시작하는 위치를 지정합니다.

Return Value

단추가 삽입된 위치이거나 오류가 발생한 경우 -1입니다.

설명

-1인 경우 iInsertAt 이 메서드는 도구 모음 단추 목록의 끝에 단추를 추가합니다.

메서드를 CMFCToolBar::InsertSeparator 호출하여 도구 모음에 구분 기호를 삽입합니다.

CMFCToolBar::InsertSeparator

도구 모음에 구분 기호를 삽입합니다.

virtual int InsertSeparator(INT_PTR iInsertAt=-1);

매개 변수

iInsertAt
[in] 구분 기호를 삽입할 0부터 시작하는 위치를 지정합니다. 이 매개 변수는 0보다 커야 합니다.

Return Value

구분 기호가 삽입된 위치이거나 오류가 발생한 경우 -1입니다.

설명

이 메서드를 호출하여 두 개의 기존 단추 사이에 구분 기호를 삽입합니다. -1인 경우 iInsertAt 이 메서드는 도구 모음 단추 목록의 끝에 구분 기호를 추가합니다.

빈 도구 모음에 구분 기호를 추가하려면 이 메서드를 사용할 수 없습니다.

메서드를 CMFCToolBar::InsertButton 호출하여 도구 모음에 단추를 삽입합니다.

CMFCToolBar::InvalidateButton

제공된 인덱스에 있는 도구 모음 단추의 클라이언트 영역을 무효화합니다.

CMFCToolBarButton* InvalidateButton(int nIndex);

매개 변수

nIndex
[in] 도구 모음에 있는 단추의 인덱스(0부터 시작하는 인덱스)입니다.

Return Value

제공된 인덱 NULL 스에 있거나 이러한 개체가 없는 경우 개체에 대한 포인터 CMFCToolBarButton 입니다.

설명

프레임워크는 도구 모음 단추와 연결된 클라이언트 영역을 업데이트할 때 이 메서드를 호출합니다. 제공된 CWnd::InvalidateRect 인덱스에 있는 개체의 CMFCToolBarButton 클라이언트 사각형을 사용하여 메서드를 호출합니다.

CMFCToolBar::IsAddRemoveQuickCustomize

사용자 지정 메뉴 옵션을 사용하여 사용자가 도구 모음 단추를 추가하거나 제거할 수 있는지 여부를 결정합니다.

BOOL IsAddRemoveQuickCustomize();

Return Value

TRUE사용자가 사용자 지정 메뉴 옵션을 사용하여 도구 모음을 수정할 수 있으면 이고, FALSE그렇지 않으면 .

설명

CMFCToolBar::IsAltCustomizeMode

빠른 사용자 지정을 사용하여 단추를 끌지 여부를 지정합니다. 빠른 사용자 지정을 사용하도록 설정하면 사용자가 Alt 키를 누른 채로 단추를 새 위치로 끌 수 있습니다.

static BOOL __stdcall IsAltCustomizeMode();

Return Value

TRUE빠른 사용자 지정을 사용하여 단추를 끌면 이고, 그렇지 않으면 . FALSE

설명

CMFCToolBar::IsAutoGrayInactiveImages

비활성(강조 표시되지 않은) 단추 이미지의 자동 생성을 사용할 수 있는지 여부를 지정합니다.

static BOOL IsAutoGrayInactiveImages();

Return Value

TRUE 비활성 이미지를 자동으로 흐리게 하는 옵션을 사용하도록 설정하면 이고, 그렇지 않으면 FALSE.

설명

를 호출 CMFCToolBar::AutoGrayInactiveImages하여 비활성 이미지의 자동 디밍을 사용하거나 사용하지 않도록 설정할 수 있습니다.

CMFCToolBar::IsBasicCommand

명령이 기본 명령 목록에 있는지 여부를 확인합니다.

static BOOL IsBasicCommand(UINT uiCmd);

매개 변수

uiCmd
[in] 확인할 명령을 지정합니다.

Return Value

TRUE 지정된 명령이 기본 명령 목록에 속하면 이고, 그렇지 않으면 FALSE.

설명

이 정적 메서드는 지정한 uiCmd 명령이 기본 명령의 전역 목록에 속하는지 여부를 결정합니다. 호출 CMFCToolBar::AddBasicCommand 하거나 CMFCToolBar::SetBasicCommands.를 호출하여 기본 명령 목록을 변경할 수 있습니다.

CMFCToolBar::IsButtonExtraSizeAvailable

도구 모음에 확장된 테두리가 있는 단추를 표시할 수 있는지 여부를 결정합니다.

virtual BOOL IsButtonExtraSizeAvailable() const;

Return Value

TRUE 막대에서 테두리 크기가 더 큰 단추를 표시할 수 있으면 이고, 그렇지 않으면 FALSE.

설명

도구 모음 개체는 확장된 테두리가 있는 단추를 표시할 수 있으면 반환 TRUE 됩니다. 도구 모음 단추는 알림을 처리할 때 이 메서드를 CMFCToolBarButton::OnChangeParentWnd 호출하고 그에 따라 내부 추가 테두리 크기 플래그를 설정합니다. 이 내부 플래그는 나중에 호출 CMFCToolBarButton::IsExtraSize하여 검색할 수 있습니다.

파생된 클래스에서 CMFCToolBar 이 메서드를 재정의하고 막대가 추가 테두리 크기로 도구 모음 단추를 표시하고 그렇지 않으면 반환할 수 있는 경우 반환 TRUE FALSE 합니다. 기본 구현은 TRUE를 반환합니다.

CMFCToolBar::IsButtonHighlighted

지정한 단추가 강조 표시되어 있는지 여부를 확인합니다.

BOOL IsButtonHighlighted(int iButton) const;

매개 변수

iButton
[in] 도구 모음 단추의 인덱스를 지정합니다.

Return Value

TRUE지정된 단추가 강조 표시되면 이고, 그렇지 않으면 . FALSE

설명

CMFCToolBar::IsCommandPermitted

명령이 허용되는지 여부를 확인합니다.

static BOOL IsCommandPermitted(UINT uiCmd);

매개 변수

uiCmd
[in] 확인할 명령을 지정합니다.

Return Value

TRUE 지정된 명령이 허용되면 이고, 그렇지 않으면 FALSE.

설명

이 정적 메서드는 지정한 uiCmd 명령이 허용되지 않는 명령의 전역 목록에 속하는지 여부를 결정합니다.

를 호출 CMFCToolBar::SetNonPermittedCommands하여 허용되지 않는 명령 목록을 변경할 수 있습니다.

CMFCToolBar::IsCommandRarelyUsed

명령이 거의 사용되지 않는지 여부를 결정합니다.

static BOOL IsCommandRarelyUsed(UINT uiCmd);

매개 변수

uiCmd
[in] 확인할 명령을 지정합니다.

Return Value

TRUE 지정된 명령이 거의 사용되지 않으면 이고, 그렇지 않으면 FALSE.

설명

메서드는 IsCommandRarelyUsed 다음 조건 중 하나 이상이 발생할 때 반환 FALSE 됩니다.

• 지정한 명령이 기본 명령 목록에 속합니다.

• 지정된 명령은 표준 명령 중 하나입니다.

• 프레임워크가 사용자 지정 모드에 있습니다.

• 기본 명령 목록이 비어 있습니다.

• 명령 호출의 20% 이상이 지정된 명령에 대한 호출입니다.

CMFCToolBar::IsCustomizeMode

도구 모음 프레임워크가 사용자 지정 모드인지 여부를 지정합니다.

static BOOL IsCustomizeMode();

Return Value

TRUE 프레임워크가 사용자 지정 모드인 경우 그렇지 않으면 FALSE.

설명

를 호출 CMFCToolBar::SetCustomizeMode하여 사용자 지정 모드를 전환할 수 있습니다.

프레임워크는 사용자가 사용자 지정 대화 상자( CMFCToolBarsCustomizeDialog 클래스)를 호출할 때 모드를 변경합니다.

CMFCToolBar::IsDragButton

도구 모음 단추를 끌지 여부를 확인합니다.

BOOL IsDragButton(const CMFCToolBarButton* pButton) const;

매개 변수

pButton
[in] 도구 모음 단추에 대한 포인터입니다.

Return Value

TRUE지정된 단추를 끌면 이고, 그렇지 않으면 . FALSE

설명

CMFCToolBar::IsExistCustomizeButton

도구 모음에 사용자 지정 단추가 포함되어 있는지 여부를 확인합니다.

BOOL IsExistCustomizeButton();

Return Value

TRUE 도구 모음에 사용자 지정 단추가 포함되어 있으면 이 고, 그렇지 않으면 FALSE.

설명

이 메서드가 반환TRUE되면 메서드는 CMFCToolBar::GetCustomizeButton 도구 모음 끝에 나타나는 사용자 지정 단추에 대한 포인터를 반환합니다.

이 메서드를 CMFCToolBar::EnableCustomizeButton 사용하여 도구 모음에 사용자 지정 단추를 추가합니다.

CMFCToolBar::IsFloating

도구 모음이 부동인지 여부를 확인합니다.

virtual BOOL IsFloating() const;

Return Value

TRUE도구 모음이 부동 중이면 FALSE

CMFCToolBar::IsLargeIcons

애플리케이션의 도구 모음에 현재 큰 아이콘이 표시되는지 여부를 지정합니다.

static BOOL IsLargeIcons();

Return Value

TRUE 애플리케이션에서 큰 아이콘을 사용하는 경우 그렇지 않으면 FALSE.

설명

큰 아이콘과 일반 아이콘 간에 토글을 호출 CMFCToolBar::SetLargeIcons 합니다.

사용자가 사용자 지정 대화 상자의 옵션 페이지에서 큰 아이콘 확인란을 전환하면 프레임워크가 모드를 자동으로 변경합니다.

CMFCToolBar::IsLastCommandFromButton

가장 최근에 실행된 명령이 지정된 도구 모음 단추에서 전송되었는지 여부를 확인합니다.

static BOOL IsLastCommandFromButton(CMFCToolBarButton* pButton);

매개 변수

pButton
[in] 단추에 대한 포인터입니다.

Return Value

TRUE 지정하는 단추에서 마지막 명령을 보냈으면 이 pButton 고, 그렇지 않으면 FALSE.입니다.

설명

이 메서드는 호출CWnd::GetCurrentMessage하여 Structure에 대한 포인터를 MSG 가져옵니다. 그런 다음 단추와 멤버를 비교하여 HWND 단추 MSG::lParam MSG::hwnd 가 명령의 원본인지 여부를 확인합니다.

CMFCToolBar::IsLocked

도구 모음이 잠겨 있는지 여부를 확인합니다.

BOOL IsLocked() const;

Return Value

TRUE도구 모음이 잠겨 있으면 FALSE

설명

이 메서드는 사용자가 도구 모음 단추 위치 변경과 같은 사용자 지정 작업을 수행할 수 없는 경우를 반환 TRUE 합니다.

잠긴 도구 모음은 별도의 이미지 목록을 사용합니다. 이러한 이미지 목록에 대한 자세한 내용은 다음을 참조하세요 CMFCToolBar::LoadBitmapEx.

CMFCToolBar::IsOneRowWithSibling

도구 모음과 해당 형제 도구 모음이 같은 행에 배치되는지 여부를 결정합니다.

BOOL IsOneRowWithSibling();

Return Value

TRUE 도구 모음과 해당 형제가 같은 행에 배치되면 FALSE.

설명

이 메서드는 CMFCCustomizeButton::CreatePopupMenu 이 메서드를 호출하여 팝업 사용자 지정 메뉴를 표시하는 방법을 결정합니다. 이 메서드가 반환TRUE되면 프레임워크는 한 행에 단추 표시 단추를 표시합니다. 그렇지 않으면 프레임워크는 두 행에 단추 표시 단추를 표시합니다 .

일반적으로 이 메서드를 사용할 필요가 없습니다. 한 행에 단추 표시 또는 두 행 단추의 단추 표시를 사용하도록 설정하려면 다음을 호출CMFCToolBar::SetSiblingToolBar합니다.

CMFCToolBar::IsResourceChanged

virtual BOOL IsResourceChanged() const;

Return Value

설명

CMFCToolBar::IsSibling

BOOL IsSibling();

Return Value

설명

CMFCToolBar::IsUserDefined

도구 모음이 사용자 정의인지 여부를 지정합니다.

BOOL IsUserDefined() const;

Return Value

TRUE 사용자가 도구 모음을 만들었으면 FALSE.

CMFCToolBar::LoadBitmap

애플리케이션 리소스에서 도구 모음 이미지를 로드합니다.

virtual BOOL LoadBitmap(
    UINT uiResID,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    BOOL bLocked=FALSE,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0);

매개 변수

uiResID
[in] 핫 도구 모음 이미지를 참조하는 비트맵의 리소스 ID입니다.

uiColdResID
[in] 콜드 도구 모음 이미지를 참조하는 비트맵의 리소스 ID입니다.

uiMenuResID
[in] 일반 메뉴 이미지를 참조하는 비트맵의 리소스 ID입니다.

bLocked
[in] TRUE 도구 모음을 잠그려면 다음을 실행합니다. 그렇지 않으면 FALSE.

uiDisabledResID
[in] 비활성화된 도구 모음 이미지를 참조하는 비트맵의 리소스 ID입니다.

uiMenuDisabledResID
[in] 비활성화된 메뉴 이미지를 참조하는 비트맵의 리소스 ID입니다.

Return Value

메서드가 성공하면 0이 아니고, 실패하면 0입니다.

설명

메서드는 CMFCToolBar::LoadToolBarEx 이 메서드를 호출하여 도구 모음과 연결된 이미지를 로드합니다. 이미지 리소스의 사용자 지정 로드를 수행하려면 이 메서드를 재정의합니다.

LoadBitmapEx 메서드를 호출하여 도구 모음을 만든 후 추가 이미지를 로드합니다.

CMFCToolBar::LoadBitmapEx

virtual BOOL LoadBitmapEx(
    CMFCToolBarInfo& params,
    BOOL bLocked = FALSE);

매개 변수

[in] params
[in] bLocked\

Return Value

설명

CMFCToolBar::LoadLargeIconsState

static BOOL __stdcall LoadLargeIconsState(LPCTSTR lpszProfileName = NULL);

매개 변수

[in] lpszProfileName\

Return Value

설명

CMFCToolBar::LoadParameters

Windows 레지스트리에서 전역 도구 모음 옵션을 로드합니다.

static BOOL LoadParameters(LPCTSTR lpszProfileName=NULL);

매개 변수

lpszProfileName
[in] Windows 레지스트리 키의 상대 경로를 지정합니다.

Return Value

메서드가 성공하면 0이 아니고, 실패하면 0입니다.

설명

이 메서드는 메뉴 애니메이션 유형, 메뉴 그림자 스타일 및 Windows 레지스트리에서 큰 아이콘을 표시할지 여부와 같은 전역 매개 변수를 로드합니다.

메서드는 CWinAppEx::LoadState 애플리케이션의 초기화 프로세스의 일부로이 메서드를 호출 합니다.

CMFCToolBar::LoadState

Windows 레지스트리에서 도구 모음 상태 정보를 로드합니다.

virtual BOOL LoadState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

매개 변수

lpszProfileName
[in] Windows 레지스트리 키의 상대 경로를 지정합니다.

nIndex
[in] 도구 모음의 컨트롤 ID를 지정합니다.

uiID
[in] 도구 모음의 리소스 ID를 지정합니다.

Return Value

메서드가 성공하면 0이 아니고, 실패하면 0입니다.

설명

프레임워크는 이 메서드를 애플리케이션 초기화 프로세스의 일부로 호출합니다. 자세한 내용은 CWinAppEx::LoadState를 참조하세요.

CMFCToolBar::LoadToolBar

애플리케이션 리소스에서 도구 모음을 로드합니다.

virtual BOOL LoadToolBar(
    UINT uiResID,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    BOOL bLocked=FALSE,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0,
    UINT uiHotResID=0);

매개 변수

uiResID
[in] 도구 모음의 리소스 ID입니다.

uiColdResID
[in] 콜드 도구 모음 이미지를 참조하는 비트맵의 리소스 ID입니다.

uiMenuResID
[in] 일반 메뉴 이미지를 참조하는 비트맵의 리소스 ID입니다.

bLocked
[in] 도구 모음이 잠겨 있는지 여부를 지정하는 부울 값입니다. 이 매개 변수인 TRUE경우 도구 모음이 잠겨 있습니다. 그렇지 않으면 도구 모음이 잠겨 있지 않습니다.

uiDisabledResID
[in] 비활성화된 도구 모음 이미지를 참조하는 비트맵의 리소스 ID입니다.

uiMenuDisabledResID
[in] 비활성화된 메뉴 이미지를 참조하는 비트맵의 리소스 ID입니다.

uiHotResID
[in] 핫 도구 모음 이미지를 참조하는 비트맵의 리소스 ID입니다.

Return Value

메서드가 성공하면 0이 아니고, 실패하면 0입니다.

설명

프레임워크는 초기화 중에 이 메서드를 호출하여 도구 모음과 연결된 이미지를 로드합니다.

예시

다음 예제에서는 클래스에서 메서드를 LoadToolBar 사용 하는 방법을 보여 줍니다 CMFCToolBar . 이 코드 조각은 IE 데모 샘플의 일부입니다.

CMFCToolBar m_wndToolBar;

// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_TRANSPARENT) ||
    !m_wndToolBar.LoadToolBar(IDR_MAINFRAME, uiToolbarColdID, uiMenuID,
                              FALSE /* Not locked */, 0, 0, uiToolbarHotID))
{
   TRACE0("Failed to create toolbar\n");
   return -1; // fail to create
}

CMFCToolBar::LoadToolBarEx

도우미 클래스를 사용하여 애플리케이션 리소스에서 도구 모음을 CMFCToolBarInfo 로드하여 애플리케이션이 큰 이미지를 사용할 수 있도록 합니다.

virtual BOOL LoadToolBarEx(
    UINT uiToolbarResID,
    CMFCToolBarInfo& params,
    BOOL bLocked=FALSE);

매개 변수

uiToolbarResID
[in] 도구 모음의 리소스 ID입니다.

params
[in] 도구 모음 이미지에 CMFCToolBarInfo 대한 리소스 ID를 포함하는 개체에 대한 참조입니다.

bLocked
[in] 도구 모음이 잠겨 있는지 여부를 지정하는 부울 값입니다. 이 매개 변수인 TRUE경우 도구 모음이 잠겨 있습니다. 그렇지 않으면 도구 모음이 잠겨 있지 않습니다.

Return Value

메서드가 성공하면 0이 아니고, 실패하면 0입니다.

설명

이 메서드를 호출하여 애플리케이션 리소스에서 도구 모음 이미지를 로드합니다.

CMFCToolBar::m_dblLargeImageRatio

큰 이미지의 차원(높이 또는 너비)과 일반 이미지의 차원 사이의 비율을 지정합니다.

AFX_IMPORT_DATA static double m_dblLargeImageRatio;

설명

기본 비율은 2입니다. 이 값을 변경하여 큰 도구 모음 이미지를 더 크거나 작게 만들 수 있습니다.

큰 이미지 집합을 지정하지 않으면 프레임워크에서 이 데이터 멤버를 사용합니다. 예를 들어 크기가 16x16인 작은 이미지 집합만 제공하고 큰 이미지의 크기가 24x24이 되도록 하려면 이 데이터 멤버를 1.5로 설정합니다.

CMFCToolBar::NextMenu

virtual BOOL NextMenu();

Return Value

설명

CMFCToolBar::OnBeforeRemoveButton

virtual BOOL OnBeforeRemoveButton(
    CMFCToolBarButton* pButton,
    DROPEFFECT dropEffect);

매개 변수

pButton
[in] 사용되지 않습니다.

dropEffect
[in] 사용되지 않습니다.

Return Value

설명

CMFCToolBar::OnChangeHot

사용자가 도구 모음에서 단추를 선택할 때 프레임워크에서 호출됩니다.

virtual void OnChangeHot(int iHot);

매개 변수

iHot
[in] 선택한 도구 모음 단추의 인덱스를 지정합니다. 또는 -1(도구 모음 단추가 선택되지 않은 경우)입니다.

설명

사용자가 도구 모음에서 단추를 선택했다는 알림을 처리하도록 이 메서드를 재정의합니다.

CMFCToolBar::OnChangeVisualManager

virtual void OnChangeVisualManager();

설명

CMFCToolBar::OnFillBackground

도구 모음 배경을 채우기 위해 프레임워크에서 CBasePane::DoPaint 호출됩니다.

virtual void OnFillBackground(CDC* pDC);

매개 변수

pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다.

설명

CMFCToolBar::DoPaint 는 도구 모음의 배경이 채워지면 이 메서드를 호출합니다. 기본 구현은 아무 작업도 수행하지 않습니다.

파생 클래스에서 사용자 지정 배경을 그리려면 이 메서드를 재정의합니다.

CMFCToolBar::OnGlobalFontsChanged

virtual void OnGlobalFontsChanged();

설명

CMFCToolBar::OnReset

도구 모음을 원래 상태로 복원합니다.

virtual void OnReset();

설명

도구 모음 재설정에 대한 알림을 처리하도록 이 메서드를 재정의합니다.

기본 구현은 아무 작업도 수행하지 않습니다. 도구 모음에 더미 단추가 있는 경우 파생된 클래스에서 CMFCToolBar 재정 OnReset 의합니다. 이 단추는 도구 모음이 원래 상태로 되돌아가면 바꿔야 합니다.

CMFCToolBar::OnSetAccData

virtual BOOL OnSetAccData(long lVal);

매개 변수

[in] lVal\

Return Value

설명

CMFCToolBar::OnSetDefaultButtonText

도구 모음 단추의 텍스트를 기본 상태로 복원합니다.

virtual BOOL OnSetDefaultButtonText(CMFCToolBarButton* pButton);

매개 변수

pButton
[in] 텍스트가 설정되는 단추를 가리킵니다.

Return Value

TRUE 텍스트가 성공적으로 복원되었으면 이고, 그렇지 않으면 FALSE.

설명

도구 모음 단추의 텍스트가 기본값으로 변경되고 있다는 알림을 처리하도록 이 메서드를 재정의합니다.

기본 구현은 애플리케이션 리소스에서 단추의 텍스트를 로드합니다.

CMFCToolBar::OnUserToolTip

단추의 도구 설명이 표시될 때 프레임워크에서 호출됩니다.

virtual BOOL OnUserToolTip(
    CMFCToolBarButton* pButton,
    CString& strTTText) const;

매개 변수

pButton
[in] 도구 설명이 표시될 도구 모음 단추를 가리킵니다.

strTTText
[out] 도구 설명의 텍스트를 받는 개체에 대한 참조 CString 입니다.

Return Value

TRUE 도구 설명 텍스트로 채워졌으면 strTTText />이고, 그렇지 않으면 FALSE.

설명

프레임워크는 도구 모음 단추의 도구 설명이 표시될 때 이 메서드를 호출합니다. 반환TRUE되는 경우 OnUserToolTip 프레임워크는 에서 반환 OnUserToolTip strTTText된 텍스트를 포함하는 도구 설명을 표시합니다. 그렇지 않으면 도구 설명에 단추 텍스트가 포함됩니다.

도구 모음 단추의 도구 팁을 사용자 지정하도록 재정 OnUserToolTip 의합니다. 기본 구현은 도구 설명 텍스트를 가져오기 위해 호출 CMFCToolBar::OnUserToolTip 합니다.

CMFCToolBar::PrevMenu

virtual BOOL PrevMenu();

Return Value

설명

CMFCToolBar::ProcessCommand

도구 모음을 WM_COMMAND 소유한 창에 메시지를 게시합니다.

BOOL ProcessCommand(CMFCToolBarButton* pButton);

매개 변수

pButton
[in] 도구 모음의 단추에 대한 포인터입니다.

Return Value

이 메서드는 항상 TRUE을 반환해야 합니다. MFC는 내부적으로 값을 사용합니다 FALSE .

설명

이 메서드는 WM_COMMAND 지정된 단추의 명령 ID를 호출 CWnd::PostMessage 하고 매개 변수로 전달하여 도구 모음을 소유하는 창에 wParam 메시지를 게시합니다.

매크로를 ON_COMMAND 사용하여 메시지를 멤버 함수에 매핑 WM_COMMAND 합니다.

CMFCToolBar::RemoveAllButtons

도구 모음에서 모든 단추와 구분 기호를 제거합니다.

virtual void RemoveAllButtons();

설명

프레임워크는 도구 모음을 다시 만들거나 삭제할 때 이 메서드를 호출합니다.

CMFCToolBar::RemoveButton

도구 모음에서 지정된 인덱스가 있는 단추를 제거합니다.

virtual BOOL RemoveButton(int iIndex);

매개 변수

iIndex
[in] 제거할 단추의 인덱스(0부터 시작하는 인덱스)를 지정합니다.

Return Value

TRUE메서드가 성공하거나 지정된 인덱스가 잘못되었거나 FALSE 인덱스가 사용자 지정 단추를 참조하는 경우

설명

이 메서드는 단추 제거의 영향을 받는 추가 도구 모음 특성을 업데이트합니다. 예를 들어 이 메서드는 도구 모음에서 기본 구분 기호를 제거하고 바로 가기 키 테이블을 다시 작성합니다.

사용자 지정 단추에 대한 자세한 내용은 다음을 참조하세요CMFCToolBar::EnableCustomizeButton.

CMFCToolBar::RemoveStateFromRegistry

Windows 레지스트리에서 도구 모음의 상태 정보를 삭제합니다.

virtual BOOL RemoveStateFromRegistry(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

매개 변수

lpszProfileName
[in] 상태 정보가 있는 레지스트리 키를 지정합니다.

nIndex
[in] 도구 모음의 컨트롤 ID입니다.

uiID
[in] 도구 모음의 리소스 ID입니다. 이 매개 변수가 -1이면 이 메서드를 CWnd::GetDlgCtrlID 사용하여 리소스 ID를 검색합니다.

Return Value

메서드가 성공하면 0이 아니고, 실패하면 0입니다.

설명

프레임워크는 사용자 정의 도구 모음을 삭제할 때 이 메서드를 호출합니다.

Windows 레지스트리에 추가 상태 정보를 저장하는 경우 이 메서드를 재정의합니다.

CMFCToolBar::ReplaceButton

도구 모음 단추를 다른 도구 모음 단추로 바꿉니다.

int ReplaceButton(
    UINT uiCmd,
    const CMFCToolBarButton& button,
    BOOL bAll=FALSE);

매개 변수

uiCmd
[in] 바꿀 단추의 명령 ID입니다.

button
[in] 삽입할 항목에 CMFCToolBarButton 대한 참조입니다.

bAll
[in] 명령 ID uiCmd가 지정된 모든 단추를 바꿀지 여부를 지정하는 부울 값입니다. 이 매개 변수인 TRUE경우 지정된 명령 ID가 있는 모든 단추가 바뀝니다. 그렇지 않으면 첫 번째 단추가 바뀝니다.

Return Value

대체되는 단추 수입니다. 이 메서드는 지정된 명령 ID가 있는 단추가 도구 모음에 없으면 0을 반환합니다.

설명

리소스에서 로드할 수 없는 도구 모음 단추를 추가하려는 경우 이 메서드를 호출합니다. 디자인 타임에 자리 표시자 단추를 만들고 도구 모음을 초기화할 때 해당 단추를 사용자 지정 단추로 바꿀 수 있습니다. 이 메서드를 사용하는 예제는 VisualStudioDemo 샘플을 참조하세요.

예시

다음 예제에서는 클래스에서 메서드를 ReplaceButton 사용 하는 방법을 보여 줍니다 CMFCToolBar . 이 코드 조각은 IE 데모 샘플의 일부입니다.

CMFCToolBar m_wndToolBar;

// CMenu menuHistory
// CString str
m_wndToolBar.ReplaceButton(ID_GO_BACK,
                           CMFCToolBarMenuButton(ID_GO_BACK, menuHistory,
                                                 GetCmdMgr()->GetCmdImage(ID_GO_BACK), str));

CMFCToolBar::ResetAll

모든 도구 모음을 원래 상태로 복원합니다.

static void __stdcall ResetAll();

설명

이 메서드는 CMFCToolBar::RestoreOriginalState 복원할 수 있는 애플리케이션의 각 도구 모음에서 메서드를 호출합니다. 이 메서드를 CMFCToolBar::CanBeRestored 사용하여 도구 모음을 복원할 수 있는지 여부를 확인합니다.

CMFCToolBar::ResetAllImages

애플리케이션의 모든 도구 모음 이미지 컬렉션을 지웁니다.

static void __stdcall ResetAllImages();

설명

이 메서드는 및 CMFCToolBar::LoadBitmap 메서드에 의해 CMFCToolBar::LoadToolBar 초기화된 이미지 컬렉션을 지웁니다.

CMFCToolBar::ResetImages

virtual void ResetImages();

설명

CMFCToolBar::RestoreFocus

virtual void RestoreFocus();

설명

CMFCToolBar::RestoreOriginalState

도구 모음의 원래 상태를 복원합니다.

virtual BOOL RestoreOriginalState();

Return Value

TRUE 메서드가 성공하거나 메서드가 실패하거나 FALSE 도구 모음이 사용자 정의인 경우

설명

이 메서드는 메서드를 사용하여 리소스 파일에서 도구 모음을 로드합니다 CMFCToolBar::LoadToolBar .

프레임워크는 사용자가 사용자 지정 대화 상자의 도구 모음 페이지에서 모두 다시 설정 단추를 선택할 때 이 메서드를 호출합니다.

CMFCToolBar::SaveParameters

static BOOL __stdcall SaveParameters(LPCTSTR lpszProfileName = NULL);

매개 변수

[in] lpszProfileName\

Return Value

설명

CMFCToolBar::SaveState

도구 모음의 상태 정보를 Windows 레지스트리에 저장합니다.

virtual BOOL SaveState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

매개 변수

lpszProfileName
[in] Windows 레지스트리 키의 상대 경로를 지정합니다.

nIndex
[in] 도구 모음의 컨트롤 ID입니다.

uiID
[in] 도구 모음의 리소스 ID입니다.

Return Value

메서드가 성공하면 0이 아니고, 실패하면 0입니다.

설명

프레임워크는 애플리케이션 상태를 레지스트리에 저장할 때 이 메서드를 호출합니다. 자세한 내용은 CWinAppEx::SaveState를 참조하세요.

CMFCToolBar::SetBasicCommands

사용자가 메뉴를 열 때 항상 표시되는 명령 목록을 설정합니다.

static void __stdcall SetBasicCommands(CList<UINT,UINT>& lstCommands);

매개 변수

lstCommands
[in] 명령 컬렉션을 포함하는 개체에 대한 참조 CList 입니다.

설명

기본 명령은 메뉴가 열릴 때 항상 표시됩니다. 이 메서드는 사용자가 최근에 사용한 명령을 보도록 선택할 때 의미가 있습니다.

메서드를 CMFCToolBar::AddBasicCommand 사용하여 기본 명령 목록에 명령을 추가합니다. 이 메서드를 CMFCToolBar::GetBasicCommands 사용하여 애플리케이션에서 사용하는 기본 명령 목록을 검색합니다.

이 메서드를 사용하는 예제는 탐색기 샘플을 참조하세요.

CMFCToolBar::SetButtonInfo

도구 모음 단추의 명령 ID, 스타일 및 이미지 ID를 설정합니다.

void SetButtonInfo(
    int nIndex,
    UINT nID,
    UINT nStyle,
    int iImage);

매개 변수

nIndex
[in] 속성이 설정된 단추의 인덱스(0부터 시작하는 인덱스)입니다.

nID
[in] 단추의 명령 ID입니다.

nStyle
[in] 단추의 스타일입니다. 사용 가능한 도구 모음 단추 스타일 목록은 도구 모음 컨트롤 스타일을 참조하세요.

iImage
[in] 단추의 0부터 시작하는 이미지 인덱스(즉, 도구 모음 이미지 컬렉션의 인덱스)입니다.

설명

도구 모음 단추의 속성을 설정하려면 이 메서드를 호출합니다.

디버그 빌드에서 이 메서드는 지정된 nIndex 인덱스가 잘못된 경우 어설션 오류를 생성합니다.

메서드를 CMFCToolBar::SetButtonStyle 호출하여 단추의 스타일만 설정합니다.

CMFCToolBar::SetButtons

도구 모음의 단추를 설정합니다.

virtual BOOL SetButtons(
    const UINT* lpIDArray,
    int nIDCount,
    BOOL bRemapImages=TRUE);

매개 변수

lpIDArray
[in] 삽입할 단추의 명령 ID 배열에 대한 포인터입니다.

nIDCount
[in] lpIDArray의 항목 수입니다.

bRemapImages
[in] 기존 단추 이미지를 삽입된 단추와 연결할지 여부를 지정하는 부울 값입니다. 이 매개 변수인 TRUE경우 이미지가 다시 매핑됩니다.

Return Value

메서드가 성공하면 0이 아니고, 실패하면 0입니다.

설명

도구 모음에서 기존 단추를 제거하고 새 단추 컬렉션을 삽입하려면 이 메서드를 호출합니다.

이 메서드는 도구 모음에 사용자 지정 단추를 추가하고 도구 모음의 부모 창에 메시지를 보냅니 AFX_WM_RESETTOOLBAR 다. 사용자 지정 단추에 대한 자세한 내용은 다음을 참조하세요CMFCToolBar::EnableCustomizeButton.

CMFCToolBar::SetButtonStyle

지정된 인덱스에서 도구 모음 단추의 스타일을 설정합니다.

virtual void SetButtonStyle(
    int nIndex,
    UINT nStyle);

매개 변수

nIndex
[in] 스타일을 설정할 도구 모음 단추의 인덱스(0부터 시작)입니다.

nStyle
[in] 단추의 스타일입니다. 사용 가능한 도구 모음 단추 스타일 목록은 도구 모음 컨트롤 스타일을 참조하세요.

설명

이 메서드는 사용자가 비활성화된 TBBS_PRESSED 단추를 선택할 수 없으므로 스타일을 nStyle TBBS_DISABLED 제거합니다.

CMFCToolBar::SetButtonText

도구 모음 단추의 텍스트 레이블을 설정합니다.

BOOL SetButtonText(
    int nIndex,
    LPCTSTR lpszText);

매개 변수

nIndex
[in] 도구 모음 단추의 인덱스입니다.

lpszText
[in] 도구 모음 단추의 텍스트 레이블입니다. null이 아니어야 합니다.

Return Value

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

설명

이 메서드는 제공된 인덱스가 유효한 도구 모음 단추를 참조하지 않는 경우 반환 FALSE 됩니다.

CMFCToolBar::SetCommandUsageOptions

애플리케이션의 메뉴에 거의 사용되지 않는 명령이 표시되지 않는 경우를 지정합니다.

static BOOL SetCommandUsageOptions(
    UINT nStartCount,
    UINT nMinUsagePercentage=5);

매개 변수

nStartCount
[in] 프레임워크에서 기본 및 최근에 사용한 명령만 표시하기 전에 명령을 실행해야 하는 횟수를 지정합니다.

nMinUsagePercentage
[in] 최근에 사용한 명령으로 간주하기 위해 명령을 실행해야 하는 횟수의 백분율입니다.

Return Value

FALSE100보다 크거나 같으면 nMinUsagePercentage 이고, 그렇지 않으면 .a0>

설명

프레임워크에서 기본 메뉴 항목과 최근에 사용한 메뉴 항목이 표시되는 방식을 결정하는 데 사용하는 알고리즘을 사용자 지정하려면 이 메서드를 호출합니다. 기본 명령에 대한 자세한 내용은 다음을 참조하세요 CMFCToolBar::AddBasicCommand.

이 클래스는 클래스를 CMFCCmdUsageCount 사용하여 명령의 사용 횟수를 추적합니다. 이 클래스에 대한 자세한 내용은 클래스를 참조 CMFCCmdUsageCount 하세요.

CMFCToolBar::SetCustomizeMode

애플리케이션의 모든 도구 모음에 대해 사용자 지정 모드를 사용하거나 사용하지 않도록 설정합니다.

static BOOL __stdcall SetCustomizeMode(BOOL bSet=TRUE);

매개 변수

bSet
[in] 사용자 지정 모드를 사용하거나 사용하지 않도록 설정할지 여부를 지정하는 부울 값입니다. 사용자 지정 모드를 TRUE 사용하거나 FALSE 사용하지 않도록 설정하려면 이 매개 변수를 설정합니다.

Return Value

TRUE 이 메서드를 호출하면 사용자 지정 모드가 변경됩니다. 그렇지 않으면 FALSE.

설명

이 메서드는 애플리케이션의 레이아웃을 조정하고 각 도구 모음을 다시 그어 줍니다. 메서드를 CMFCToolBar::IsCustomizeMode 호출하여 애플리케이션이 사용자 지정 모드인지 여부를 확인합니다.

CMFCToolBar::SetGrayDisabledButtons

도구 모음에서 사용할 수 없는 단추가 흐리게 표시되는지 또는 단추를 사용할 수 없는 이미지를 사용할 수 없는지 여부를 지정합니다.

void SetGrayDisabledButtons(BOOL bGrayDisabledButtons);

매개 변수

bGrayDisabledButtons
[in] 사용할 수 없는 단추를 표시하는 방법을 지정하는 부울 값입니다. 이 매개 변수인 TRUE경우 프레임워크는 단추를 흐리게 합니다. 그렇지 않으면 프레임워크는 단추를 사용할 수 없는 이미지 컬렉션을 사용합니다.

설명

기본적으로 사용할 수 없는 단추는 흐리게 표시됩니다.

CMFCToolBar::SetHeight

도구 모음의 높이를 설정합니다.

void SetHeight(int cyHeight);

매개 변수

cyHeight
[in] 도구 모음의 높이(픽셀)입니다.

설명

이 메서드는 높이를 설정한 후 도구 모음을 다시 그어 줍니다.

CMFCToolBar::SetHelpMode

static void __stdcall SetHelpMode(BOOL bOn = TRUE);

매개 변수

[in] bOn\

설명

CMFCToolBar::SetHot

BOOL SetHot(CMFCToolBarButton* pMenuButton);

매개 변수

[in] pMenuButton\

Return Value

설명

CMFCToolBar::SetHotBorder

도구 모음 단추가 핫 트랙되는지 여부를 지정합니다.

void SetHotBorder(BOOL bShowHotBorder);

매개 변수

bShowHotBorder
[in] 도구 모음 단추를 핫 트랙할지 여부를 지정하는 부울 값입니다. 이 매개 변수인 TRUE경우 도구 모음은 해당 단추를 핫 추적합니다. 그렇지 않으면 도구 모음이 해당 단추를 핫트랙하지 않습니다.

설명

단추가 핫 트랙인 경우 프레임워크는 마우스가 단추를 가로질러 이동할 때 단추를 강조 표시합니다. 기본적으로 각 도구 모음은 해당 단추를 핫 추적합니다.

메서드를 CMFCToolBar::GetHotBorder 호출하여 도구 모음이 해당 단추를 핫 추적하는지 여부를 확인합니다.

CMFCToolBar::SetHotTextColor

핫 도구 모음 단추의 텍스트 색을 설정합니다.

static void SetHotTextColor(COLORREF clrText);

매개 변수

clrText
[in] 핫 추적되는 도구 모음 단추의 텍스트 색을 지정합니다.

설명

핫 트랙 도구 모음 단추에 대한 자세한 내용은 다음을 참조 CMFCToolBar::GetHotBorder 하세요 CMFCToolBar::SetHotBorder.

CMFCToolBar::SetIgnoreSetText

void SetIgnoreSetText(BOOL bValue);

매개 변수

[in] bValue\

설명

CMFCToolBar::SetLargeIcons

도구 모음 단추에 큰 아이콘이 표시되는지 여부를 지정합니다.

static void SetLargeIcons(BOOL bLargeIcons=TRUE);

매개 변수

bLargeIcons
[in] 사용할 아이콘을 지정하는 부울 값입니다. 이 매개 변수인 TRUE경우 프레임워크는 큰 아이콘을 표시합니다. 그렇지 않으면 프레임워크에 일반 아이콘이 표시됩니다.

설명

프레임워크는 사용자가 사용자 지정 대화 상자의 옵션 탭에서 큰 아이콘 확인란의 상태를 변경할 때 이 메서드를 호출합니다. 이 메서드는 애플리케이션의 모든 도구 모음 크기를 조정합니다.

기본적으로 프레임워크는 일반 아이콘을 표시합니다.

사용자 지정 대화 상자에 대한 자세한 내용은 클래스를 참조 CMFCToolBarsCustomizeDialog 하세요.

CMFCToolBar::SetLockedSizes

도구 모음에서 잠긴 단추 및 잠긴 이미지의 크기를 설정합니다.

void SetLockedSizes(
    SIZE sizeButton,
    SIZE sizeImage,
    BOOL bDontScale = FALSE);

매개 변수

sizeButton
[in] 잠긴 도구 모음 단추의 크기를 지정합니다.

sizeImage
[in] 잠긴 도구 모음 이미지의 크기를 지정합니다.

bDontScale
높은 DPI 모드에서 잠긴 도구 모음 이미지의 크기를 조정할지 여부를 지정합니다.

설명

잠긴 단추의 기본 크기는 23x22 픽셀입니다. 잠긴 이미지의 기본 크기는 16x15 픽셀입니다.

메서드를 CMFCToolBar::GetLockedImageSize 호출하여 잠긴 이미지의 크기를 검색합니다. 메서드를 CMFCToolBar::GetButtonSize 호출하여 잠긴 도구 모음 단추의 크기를 검색합니다.

CMFCToolBar::SetMaskMode

void SetMaskMode(BOOL bMasked);

매개 변수

[in] bMasked\

설명

CMFCToolBar::SetMenuSizes

도구 모음 메뉴 단추 및 해당 이미지의 크기를 설정합니다.

static void __stdcall SetMenuSizes(
    SIZE sizeButton,
    SIZE sizeImage);

매개 변수

sizeButton
[in] 도구 모음 단추의 크기를 픽셀 단위로 지정합니다.

sizeImage
[in] 도구 모음 이미지의 크기를 픽셀 단위로 지정합니다.

설명

기본적으로 메뉴 단추와 해당 이미지의 크기는 정의되지 않습니다.

메서드를 CMFCToolBar::GetMenuButtonSize 호출하여 메뉴 단추의 크기와 메뉴 단추 CMFCToolBar::GetMenuImageSize 이미지의 크기를 결정하는 메서드를 결정합니다.

이 메서드를 사용하는 예제는 IEDemo 및 MSMoneyDemo 샘플을 참조하세요.

CMFCToolBar::SetNonPermittedCommands

사용자가 실행할 수 없는 명령 목록을 설정합니다.

static void SetNonPermittedCommands(CList<UINT,UINT>& lstCommands);

매개 변수

lstCommands
[in] 사용자가 실행할 수 없는 명령이 포함된 개체에 대한 참조 CList 입니다.

설명

사용자가 특정 명령을 선택하지 못하도록 하려면 이 메서드를 호출합니다. 예를 들어 사용자가 보안상의 이유로 특정 명령을 선택하지 못하도록 할 수 있습니다. 이 메서드를 사용하는 예제는 MDITabsDemo 및 MenuSubSet 샘플을 참조하세요.

이 메서드는 허용되지 않는 명령의 이전 목록을 지웁니다. 기본적으로 허용되지 않는 명령 목록은 비어 있습니다.

CMFCToolBar::SetOneRowWithSibling

도구 모음과 해당 형제를 같은 행에 배치합니다.

void SetOneRowWithSibling();

설명

프레임워크는 사용자가 한 행의 단추 표시 단추를 선택할 때 이 메서드를 호출합니다.

메서드를 CMFCToolBar::SetSiblingToolBar 호출하여 한 행에 단추 표시 또는 두 행 단추의 단추 표시를 사용하도록 설정합니다. 이 도구 모음을 호출 CMFCToolBar::SetSiblingToolBar 하면 형제 도구 모음이 이 도구 모음의 행으로 이동됩니다. 그렇지 않으면 이 도구 모음이 형제의 행으로 이동됩니다.

프레임워크는 사용자가 두 행의 단추 표시 단추를 선택할 때 메서드를 호출 CMFCToolBar::SetTwoRowsWithSibling 합니다.

CMFCToolBar::SetOrigButtons

void SetOrigButtons(const CObList& lstOrigButtons);

매개 변수

[in] lstOrigButtons\

설명

CMFCToolBar::SetPermament

사용자가 도구 모음을 닫을 수 있는지 여부를 지정합니다.

void SetPermament(BOOL bPermament=TRUE);

매개 변수

bPermament
[in] 사용자가 도구 모음을 닫을 수 있는지 여부를 지정하는 부울 값입니다. 이 매개 변수인 TRUE경우 사용자가 도구 모음을 닫을 수 없습니다. 그렇지 않으면 사용자가 도구 모음을 닫을 수 있습니다.

설명

기본적으로 사용자는 각 도구 모음을 닫을 수 있습니다.

메서드를 CMFCToolBar::CanBeClosed 호출하여 사용자가 도구 모음을 닫을 수 있는지 여부를 확인합니다.

CMFCToolBar::SetRouteCommandsViaFrame

부모 프레임 또는 소유자가 도구 모음에 명령을 보낼지 여부를 지정합니다.

void SetRouteCommandsViaFrame(BOOL bValue);

매개 변수

bValue
[in] 이 매개 변수인 TRUE경우 부모 프레임은 도구 모음에 명령을 보냅니다. 그렇지 않으면 소유자가 도구 모음에 명령을 보냅니다.

설명

기본적으로 부모 프레임은 도구 모음에 명령을 보냅니다. 메서드를 CMFCToolBar::GetRouteCommandsViaFrame 호출하여 부모 프레임 또는 소유자가 도구 모음에 명령을 보내는지 여부를 확인합니다.

CMFCToolBar::SetShowTooltips

프레임워크에 도구 팁이 표시되는지 여부를 지정합니다.

static void SetShowTooltips(BOOL bValue);

매개 변수

bValue
[in] 이 매개 변수인 TRUE경우 프레임워크에 도구 팁이 표시됩니다. 그렇지 않으면 프레임워크는 도구 팁을 숨깁니다.

설명

기본적으로 프레임워크에는 도구 팁이 표시됩니다.

메서드를 CMFCToolBar::GetShowTooltips 호출하여 프레임워크에 도구 팁이 표시되는지 여부를 확인합니다.

CMFCToolBar::SetSiblingToolBar

도구 모음의 형제를 지정합니다.

void SetSiblingToolBar(CMFCToolBar* pBrotherToolbar);

매개 변수

pBrotherToolbar
[in] 형제 도구 모음에 대한 포인터입니다.

설명

이 방법을 사용하면 사용자가 사용자 지정 팝업 메뉴를 표시할 때 표시되는 한 행의 단추 표시 또는 두 행 단추의 단추 표시를 사용할 수 있습니다. 사용자가 관련 도구 모음이 같은 행에 표시되는지 아니면 다른 행에 표시되는지 여부를 지정할 수 있도록 하려면 이 메서드를 호출합니다.

도구 모음에 나타나는 사용자 지정 단추를 사용하도록 설정한 후 이 메서드를 호출합니다. 사용자 지정 단추를 사용하도록 설정하려면 메서드를 호출합니다CMFCToolBar::EnableCustomizeButton.

도구 모음의 형제를 검색하려면 .를 호출 CMFCToolBar::GetSiblingToolBar합니다.

CMFCToolBar::SetSizes

모든 도구 모음의 단추 및 이미지 크기를 지정합니다.

static void __stdcall SetSizes(
    SIZE sizeButton,
    SIZE sizeImage);

매개 변수

sizeButton
[in] 도구 모음 단추의 크기(픽셀)입니다.

sizeImage
[in] 도구 모음 단추 이미지의 크기(픽셀)입니다.

설명

도구 모음 단추의 기본 크기는 23x22 픽셀입니다. 도구 모음 단추 이미지의 기본 크기는 16x15 픽셀입니다.

메서드를 CMFCToolBar::GetImageSize 호출하여 도구 모음 단추 이미지의 크기를 검색합니다. 메서드를 CMFCToolBar::GetButtonSize 호출하여 도구 모음 단추의 크기를 검색합니다.

CMFCToolBar::SetToolBarBtnText

도구 모음에 있는 단추의 속성을 지정합니다.

void SetToolBarBtnText(
    UINT nBtnIndex,
    LPCTSTR szText=NULL,
    BOOL bShowText=TRUE,
    BOOL bShowImage=TRUE);

매개 변수

nBtnIndex
[in] 도구 모음 단추 목록에 있는 도구 모음 단추의 인덱스(0부터 시작하는 인덱스)입니다.

szText
[in] 도구 모음 단추의 텍스트 레이블을 지정합니다.

bShowText
[in] 이 매개 변수인 TRUE경우 프레임워크는 텍스트 레이블을 표시합니다. 그렇지 않으면 프레임워크는 텍스트 레이블을 숨깁니다.

bShowImage
[in] 이 매개 변수인 TRUE경우 프레임워크는 도구 모음 단추 이미지를 표시합니다. 그렇지 않으면 프레임워크가 도구 모음 단추 이미지를 숨깁니다.

설명

기본적으로 프레임워크는 도구 모음 단추의 이미지를 표시하지만 도구 모음 단추의 텍스트 레이블은 표시하지 않습니다.

디버그 빌드에서 이 메서드는 유효한 도구 모음 단추를 참조하지 않거나 도구 모음 단추가 구분 기호인 경우 nBtnIndex 어설션 오류를 생성합니다.

CMFCToolBar::SetTwoRowsWithSibling

도구 모음과 해당 형제를 별도의 행에 배치합니다.

void SetTwoRowsWithSibling();

설명

프레임워크는 사용자가 두 행의 단추 표시 단추를 선택할 때 이 메서드를 호출합니다 .

메서드를 CMFCToolBar::SetSiblingToolBar 호출하여 한 행에 단추 표시 또는 두 행 단추의 단추 표시를 사용하도록 설정합니다. 이 도구 모음을 호출 CMFCToolBar::SetSiblingToolBar 하면 형제 도구 모음이 별도의 행으로 이동됩니다. 그렇지 않으면 이 도구 모음이 별도의 행으로 이동됩니다.

프레임워크는 사용자가 한 행의 단추 표시 단추를 선택할 때 메서드를 호출 CMFCToolBar::SetOneRowWithSibling 합니다.

CMFCToolBar::SetUserImages

애플리케이션에서 사용자 정의 이미지의 컬렉션을 설정합니다.

static BOOL SetUserImages(CMFCToolBarImages* pUserImages);

매개 변수

pUserImages
[in] 사용자 정의 이미지 컬렉션에 대한 포인터입니다.

Return Value

메서드가 성공하면 0이 아닌 경우 지정한 CMFCToolBarImages 개체가 유효하지 않거나 도구 모음의 기본 이미지 크기와 다른 이미지 크기를 가지면 0이 됩니다.

설명

프레임워크는 사용자 정의 이미지를 사용하여 사용자가 사용자 지정한 도구 모음 단추를 그립니다. 지정한 pUserImages 이미지 목록은 애플리케이션의 모든 도구 모음에서 공유됩니다.

이 메서드는 지정된 CMFCToolBarImages 개체가 유효하지 않거나 도구 모음의 기본 이미지 크기와 다른 이미지 크기가 있는 경우 디버그 빌드에서 어설션 오류를 생성합니다.

OutlookDemo, ToolTipDemo 및 VisualStudioDemo 샘플은 이 메서드를 사용하여 사용자 정의 이미지의 전역 컬렉션을 설정합니다. 애플리케이션의 작업 디렉터리에 있는 UserImages.bmp 이름이 지정된 파일을 로드합니다.

'CMFCToolBar::GetUserImages 메서드를 호출하여 애플리케이션에서 사용자 정의 이미지 컬렉션을 검색합니다.

CMFCToolBar::StretchPane

도구 모음을 세로 또는 가로로 늘이고 필요한 경우 단추 위치를 변경합니다.

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

매개 변수

nLength
[in] 창을 확장할 크기(픽셀)입니다.

bVert
[in] 이면 TRUE창을 세로로 늘입니다. 이면 FALSE창을 가로로 늘입니다.

Return Value

CSize 도구 모음 클라이언트 영역의 크기를 지정하는 개체입니다.

설명

이 메서드는 확장된 도구 모음 내의 단추 위치를 변경하기 위해 호출 CMFCToolBar::WrapToolBar 합니다.

반환 값은 호출 CMFCToolBar::CalcSize에 의해 결정됩니다.

CMFCToolBar::TranslateChar

지정된 키 코드가 유효한 바로 가기 키에 해당하는 경우 단추 명령을 실행합니다.

virtual BOOL TranslateChar(UINT nChar);

매개 변수

nChar
[in] 가상 키 코드를 지정합니다. 표준 가상 키 코드 목록은 Winuser.h

Return Value

FALSE 지정된 키 코드가 인쇄할 수 없거나 유효한 바로 가기 키에 해당하지 않는 경우 TRUE 지정된 키 코드가 드롭다운 메뉴 옵션에 해당하면 이고, 그렇지 않으면 반환 값입니다 CMFCToolBar::ProcessCommand.

설명

Alt 키와 함께 키를 누르면 프레임워크에서 이 메서드를 호출합니다.

CMFCToolBar::UpdateButton

지정된 단추의 상태를 업데이트합니다.

void UpdateButton(int nIndex);

매개 변수

nIndex
[in] 업데이트할 단추의 인덱스(0부터 시작하는 인덱스)를 지정합니다.

설명

CMFCToolBar::WrapToolBar

지정된 차원 내의 도구 모음 단추 위치를 변경합니다.

int WrapToolBar(
    int nWidth,
    int nHeight = 32767,
    CDC* pDC = NULL,
    int nColumnWidth = -1,
    int nRowHeight = -1);

매개 변수

nWidth
[in] 도구 모음의 최대 너비입니다.

nHeight
[in] 도구 모음의 최대 높이입니다. 도구 모음이 부동하는 경우에는 사용되지 않습니다.

pDC
[in] 디바이스 컨텍스트에 대한 포인터입니다. 이 경우 NULL도구 모음의 디바이스 컨텍스트가 사용됩니다.

nColumnWidth
[in] 단추 너비입니다. -1이면 현재 너비가 사용됩니다.

[in] m nRowHeight 단추 높이입니다. -1이면 현재 높이가 사용됩니다.

Return Value

도구 모음의 단추 행 수입니다.

설명

이 메서드는 도구 모음 내의 단추 위치를 변경하고 필요한 경우 단추를 추가 행으로 래핑합니다.

CMFCToolBar::m_bDontScaleImages

높은 DPI 모드에서 도구 모음 이미지의 크기를 조정할지 여부를 지정합니다. 이미지 크기가 단추 크기와 일치하지 않을 때 이미지 크기 조정을 방지하도록 TRUE 설정합니다.

AFX_IMPORT_DATA static BOOL m_bDontScaleImages;

참고 항목

계층 구조 차트
클래스
CMFCMenuBar 클래스
CMFCPopupMenuBar 클래스
CMFCDropDownToolBar 클래스
연습: 도구 모음에 컨트롤 배치