다음을 통해 공유

CMFCToolBarButton 클래스

  • 아티클

도구 모음에 단추 기능을 제공합니다.

구문

class CMFCToolBarButton : public CObject

멤버

공용 생성자

속성 설명
CMFCToolBarButton::CMFCToolBarButton CMFCToolBarButton 개체를 생성하고 초기화합니다.
CMFCToolBarButton::~CMFCToolBarButton 소멸자

공용 메서드

이름 설명
CMFCToolBarButton::CanBeDropped 사용자가 사용자 지정 중에 도구 모음이나 메뉴에 단추를 배치할 수 있는지 여부를 지정합니다.
CMFCToolBarButton::CanBeStored 단추를 저장할 수 있는지 여부를 지정합니다.
CMFCToolBarButton::CanBeStretched 사용자 지정 중에 사용자가 단추를 늘릴 수 있는지 여부를 지정합니다.
CMFCToolBarButton::CompareWith 이 인스턴스를 제공된 CMFCToolBarButton 개체와 비교합니다.
CMFCToolBarButton::CopyFrom 다른 도구 모음 단추의 속성을 현재 단추에 복사합니다.
CMFCToolBarButton::CreateFromOleData 제공된 CMFCToolBarButton 개체에서 개체를 COleDataObject 만듭니다.
CMFCToolBarButton::CreateObject 프레임워크에서 이 클래스 형식의 동적 인스턴스를 만드는 데 사용합니다.
CMFCToolBarButton::EnableWindow 마우스 및 키보드 입력을 사용하거나 사용하지 않도록 설정합니다.
CMFCToolBarButton::ExportToMenuButton 도구 모음 단추에서 메뉴로 텍스트를 복사합니다.
CMFCToolBarButton::GetClipboardFormat 애플리케이션의 전역 클립보드 형식을 검색합니다.
CMFCToolBarButton::GetHwnd 도구 모음 단추와 연결된 창 핸들을 검색합니다.
CMFCToolBarButton::GetImage 단추의 이미지 인덱스를 검색합니다.
CMFCToolBarButton::GetInvalidateRect 다시 그려야 하는 단추의 클라이언트 영역 영역을 검색합니다.
CMFCToolBarButton::GetParentWnd 단추의 부모 창을 검색합니다.
CMFCToolBarButton::GetProtectedCommands 사용자가 사용자 지정할 수 없는 명령 목록을 검색합니다.
CMFCToolBarButton::GetTextSize 단추 텍스트의 크기를 검색합니다.
CMFCToolBarButton::HasFocus 단추에 현재 입력 포커스가 있는지 여부를 확인합니다.
CMFCToolBarButton::HaveHotBorder 사용자가 단추를 선택할 때 단추의 테두리가 표시되는지 여부를 결정합니다.
CMFCToolBarButton::IsDrawImage 단추에 이미지가 표시되는지 여부를 결정합니다.
CMFCToolBarButton::IsDrawText 단추에 텍스트 레이블이 표시되는지 여부를 결정합니다.
CMFCToolBarButton::IsDroppedDown 단추에 하위 메뉴가 표시되는지 여부를 결정합니다.
CMFCToolBarButton::IsEditable 단추를 사용자 지정할 수 있는지 여부를 결정합니다.
CMFCToolBarButton::IsExtraSize 확장된 테두리를 사용하여 단추를 표시할 수 있는지 여부를 결정합니다.
CMFCToolBarButton::IsFirstInGroup 단추가 단추 그룹의 첫 번째 위치에 있는지 여부를 확인합니다.
CMFCToolBarButton::IsHidden 단추가 숨겨져 있는지 여부를 확인합니다.
CMFCToolBarButton::IsHorizontal 단추가 가로 도구 모음에 있는지 여부를 결정합니다.
CMFCToolBarButton::IsLastInGroup 단추가 단추 그룹의 마지막 위치에 있는지 여부를 지정합니다.
CMFCToolBarButton::IsLocked 단추가 잠긴(사용자 지정 불가능) 도구 모음에 있는지 여부를 확인합니다.
CMFCToolBarButton::IsOwnerOf 단추가 제공된 창 핸들의 소유자인지 여부를 확인합니다.
CMFCToolBarButton::IsVisible 도구 모음 단추가 표시되는지 여부를 확인합니다.
CMFCToolBarButton::IsWindowVisible 단추의 기본 창 핸들이 표시되는지 여부를 확인합니다.
CMFCToolBarButton::NotifyCommand 단추가 WM_COMMAND 메시지를 처리하는지 여부를 지정합니다.
CMFCToolBarButton::OnAddToCustomizePage 사용자 지정 대화 상자에 단추를 추가할 때 프레임워크에서 호출됩니다.
CMFCToolBarButton::OnBeforeDrag 단추를 끌 수 있는지 여부를 지정합니다.
CMFCToolBarButton::OnBeforeDrop 사용자가 대상 도구 모음에 단추를 놓을 수 있는지 여부를 지정합니다.
CMFCToolBarButton::OnCalculateSize 프레임워크에서 지정된 디바이스 컨텍스트 및 도킹 상태에 대한 단추 크기를 계산하기 위해 호출됩니다.
CMFCToolBarButton::OnCancelMode WM_CANCELMODE 메시지를 처리하기 위해 프레임워크에서 호출됩니다.
CMFCToolBarButton::OnChangeParentWnd 단추가 새 도구 모음에 삽입될 때 프레임워크에서 호출됩니다.
CMFCToolBarButton::OnClick 사용자가 마우스 단추를 클릭할 때 프레임워크에서 호출됩니다.
CMFCToolBarButton::OnClickUp 사용자가 마우스 단추를 놓을 때 프레임워크에서 호출됩니다.
CMFCToolBarButton::OnContextHelp 부모 도구 모음이 WM_HELPHITTEST 메시지를 처리할 때 프레임워크에서 호출됩니다.
CMFCToolBarButton::OnCtlColor 부모 도구 모음이 WM_CTLCOLOR 메시지를 처리할 때 프레임워크에서 호출됩니다.
CMFCToolBarButton::OnCustomizeMenu 응용 프로그램이 부모 도구 모음에 바로 가기 메뉴를 표시할 때 단추가 제공된 메뉴를 수정할 수 있도록 합니다.
CMFCToolBarButton::OnDblClk 부모 도구 모음이 WM_LBUTTONDBLCLK 메시지를 처리할 때 프레임워크에서 호출됩니다.
CMFCToolBarButton::OnDraw 지정된 스타일 및 옵션을 사용하여 단추를 그리기 위해 프레임워크에서 호출됩니다.
CMFCToolBarButton::OnDrawOnCustomizeList 사용자 지정 대화 상자의 명령 창에서 단추를 그리기 위해 프레임워크에서 호출됩니다.
CMFCToolBarButton::OnGetCustomToolTipText 단추에 대한 사용자 지정 도구 설명 텍스트를 검색하기 위해 프레임워크에서 호출됩니다.
CMFCToolBarButton::OnGlobalFontsChanged 전역 글꼴이 변경되면 프레임워크에서 호출됩니다.
CMFCToolBarButton::OnMove 부모 도구 모음이 이동할 때 프레임워크에서 호출됩니다.
CMFCToolBarButton::OnShow 단추가 표시되거나 보이지 않는 경우 프레임워크에서 호출됩니다.
CMFCToolBarButton::OnSize 부모 도구 모음이 크기 또는 위치를 변경하고 이 변경을 수행하려면 단추가 크기를 변경해야 할 때 프레임워크에서 호출됩니다.
CMFCToolBarButton::OnToolHitTest 부모 도구 모음에서 단추의 경계 사각형에 점이 있는지 여부를 결정해야 하는 경우 프레임워크에서 호출됩니다.
CMFCToolBarButton::OnUpdateToolTip 부모 도구 모음이 도구 설명 텍스트를 업데이트할 때 프레임워크에서 호출됩니다.
CMFCToolBarButton::P repareDrag 단추가 끌어서 놓기 작업을 수행하려고 할 때 프레임워크에서 호출됩니다.
CMFCToolBarButton::Rect 단추의 경계 사각형을 검색합니다.
CMFCToolBarButton::ResetImageToDefault 단추와 연결된 이미지의 기본값으로 설정합니다.
CMFCToolBarButton::SaveBarState 도구 모음 단추의 상태를 저장합니다.
CMFCToolBarButton::Serialize 보관 파일에서 이 개체를 읽거나 보관 파일에 씁니다. ( CObject::Serialize를 재정의합니다.)
CMFCToolBarButton::SetACCData 제공된 개체를 CAccessibilityData 도구 모음 단추의 접근성 데이터로 채웁니다.
CMFCToolBarButton::SetClipboardFormatName 전역 클립보드 형식의 이름을 바꿉니다.
CMFCToolBarButton::SetImage 단추의 이미지 인덱스 설정
CMFCToolBarButton::SetProtectedCommands 사용자가 사용자 지정할 수 없는 명령 목록을 설정합니다.
CMFCToolBarButton::SetRadio 단추가 선택된 상태를 변경할 때 프레임워크에서 호출됩니다.
CMFCToolBarButton::SetRect 단추의 경계 사각형을 설정합니다.
CMFCToolBarButton::SetStyle 단추의 스타일을 설정합니다.
CMFCToolBarButton::SetVisible 단추가 표시되는지 여부를 지정합니다.
CMFCToolBarButton::Show 버튼을 표시하거나 숨깁니다.

데이터 멤버

속성 설명
CMFCToolBarButton::m_bImage 단추에 이미지가 표시되는지 여부를 지정합니다.
CMFCToolBarButton::m_bText 단추에 텍스트 레이블이 표시되는지 여부를 지정합니다.
CMFCToolBarButton::m_bTextBelow 단추의 이미지 아래에 텍스트 레이블이 표시되는지 여부를 지정합니다.
CMFCToolBarButton::m_bUserButton 단추에 사용자 정의 이미지가 있는지 여부를 지정합니다.
CMFCToolBarButton::m_bWholeText 경계 사각형에 맞지 않더라도 단추가 전체 텍스트 레이블을 표시할지 여부를 지정합니다.
CMFCToolBarButton::m_bWrap 구분 기호 옆에 있는 단추를 다음 행에 배치할지 여부를 지정합니다.
CMFCToolBarButton::m_bWrapText 여러 줄 텍스트 레이블을 사용할 수 있는지 여부를 지정합니다.
CMFCToolBarButton::m_nID 단추의 명령 ID입니다.
CMFCToolBarButton::m_nStyle 단추의 스타일입니다.
CMFCToolBarButton::m_strText 단추의 텍스트 레이블입니다.

설명

CMFCToolbarButton 개체는 도구 모음에 있는 컨트롤입니다. 동작은 일반 단추의 동작과 유사합니다. 이 개체에 이미지와 텍스트 레이블을 할당할 수 있습니다. 도구 모음 단추에는 명령 ID도 있을 수 있습니다. 사용자가 도구 모음 단추를 클릭하면 프레임워크는 이 ID가 지정하는 명령을 실행합니다.

일반적으로 도구 모음 단추를 사용자 지정할 수 있습니다. 사용자는 한 도구 모음에서 다른 도구 모음으로 단추를 끌어 텍스트 레이블과 이미지를 복사, 붙여넣기, 삭제 및 편집할 수 있습니다. 사용자가 도구 모음을 사용자 지정하지 못하도록 하려면 두 가지 방법 중 하나로 도구 모음을 잠글 수 있습니다. CMFCToolBar::LoadToolBar를 호출할 때 플래그를 TRUE로 설정 bLocked 하거나 CMFCToolBarButton::SetProtectedCommands 메서드를 사용하여 개별 단추의 명령 ID를 보호된 명령의 전역 목록에 추가합니다.

CMFCToolBarButton 개체는 애플리케이션에서 도구 모음 이미지의 전역 컬렉션에서 이미지를 표시합니다. 이러한 컬렉션은 부모 도구 모음 인 CMFCToolBar 클래스에 의해 유지 관리됩니다. 자세한 내용은 CMFCToolBarImages 클래스를 참조 하세요.

사용자가 도구 모음 단추를 클릭하면 부모 도구 모음이 마우스 메시지를 처리하고 적절한 작업을 단추에 전달합니다. 단추에 유효한 명령 ID가 있는 경우 부모 도구 모음은 부모 프레임에 WM_COMMAND 메시지를 보냅니다.

이 CMFCToolBarButton 클래스는 CMFCToolBarMenuButton 클래스, CMFCToolBarEditBoxButton 클래스 및 CMFCToolBarComboBoxButton 클래스와 같은 다른 도구 모음 단추 클래스의 기본 클래스입니다.

예시

다음 예제에서는 클래스의 다양한 메서드를 사용하여 개체를 CMFCToolBarButton 구성하는 방법을 보여 줍니다 CMFCToolBarButton . 이 예제에서는 마우스 및 키보드 입력을 사용하도록 설정하고, 단추의 이미지 인덱스를 설정하고, 단추의 경계 사각형을 설정하고, 단추를 표시하도록 하는 방법을 보여 줍니다. 이 코드 조각은 Tab Control 샘플의 일부입니다.

CMFCToolBarButton *pOffice2007 = NULL;
int nIndex = -1;

for (UINT uiCmd = ID_VIEW_APPLOOK_2007_1; uiCmd <= ID_VIEW_APPLOOK_2007_4; uiCmd++)
{
   // CMFCToolBar m_wndToolBarTheme
   nIndex = m_wndToolBarTheme.CommandToIndex(uiCmd);

   CMFCToolBarButton *pButton = m_wndToolBarTheme.GetButton(nIndex);

   if (pButton != NULL)
   {
      pOffice2007 = pButton;
      break;
   }
}

pOffice2007->EnableWindow();
pOffice2007->SetImage(1);
pOffice2007->SetRect(CRect(1, 1, 1, 1));
pOffice2007->SetVisible();
pOffice2007->Show(true);

상속 계층 구조

CObject

CMFCToolBarButton

요구 사항

헤더: afxtoolbarbutton.h

CMFCToolBarButton::CanBeDropped

사용자가 사용자 지정 중에 도구 모음이나 메뉴에 단추를 배치할 수 있는지 여부를 지정합니다.

virtual BOOL CanBeDropped(CMFCToolBar* pToolbar);

매개 변수

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

Return Value

이 메서드는 TRUE를 반환합니다.

설명

기본적으로 도구 모음 단추는 사용자 지정 가능한 모든 도구 모음(즉, 잠겨 있지 않은) 도구 모음에서 삭제할 수 있습니다.

이 메서드의 기본 구현은 TRUE를 반환합니다. 사용자가 단추의 위치를 변경할 수 없도록 하려면 이 메서드를 재정의하고 FALSE를 반환합니다.

CMFCToolBarButton::CanBeStored

단추를 저장할 수 있는지 여부를 결정합니다.

virtual BOOL CanBeStored() const;

Return Value

이 메서드는 TRUE를 반환합니다.

설명

프레임워크는 이 메서드를 사용하여 단추가 끌어서 놓기 작업에 참여할 수 있는지 여부를 결정합니다.

기본 구현은 TRUE를 반환합니다. 끌어서 놓기 작업의 일부로 단추를 저장할 수 없는 경우 이 메서드를 재정의합니다. 끌어서 놓기 작업에 대한 자세한 내용은 OLE 끌어서 놓기 작업을 참조 하세요.

CMFCToolBarButton::CanBeStretched

사용자 지정 중에 사용자가 단추를 늘릴 수 있는지 여부를 지정합니다.

virtual BOOL CanBeStretched() const;

Return Value

이 메서드는 FALSE를 반환합니다.

설명

이 메서드는 사용자 지정 모드에서 단추를 확장할 수 있는지 여부를 결정 하기 위해 프레임 워크에서 사용 됩니다.

이 메서드의 기본 구현은 FALSE를 반환합니다. 콤보 상자 또는 슬라이더와 같은 가변 너비 컨트롤에 대해 TRUE를 반환하도록 이 메서드를 재정의합니다.

사용자 지정 모드에 대한 자세한 내용은 CMFCToolBar::SetCustomizeMode를 참조하세요.

CMFCToolBarButton::CMFCToolBarButton

CMFCToolBarButton 개체를 생성하고 초기화합니다.

CMFCToolBarButton(
    UINT uiID,
    int iImage,
    LPCTSTR lpszText=NULL,
    BOOL bUserButton=FALSE,
    BOOL bLocked=FALSE);

매개 변수

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

iImage
[in] 이미지 컬렉션에 있는 단추의 이미지 인덱스입니다.

lpszText
[in] 단추의 텍스트 레이블입니다. NULL일 수 있습니다.

bUserButton
[in] 단추가 사용자 정의인지 여부를 결정하는 부울 값입니다. 이 매개 변수가 TRUE이면 단추가 사용자 정의입니다. 그렇지 않으면 단추 이미지가 리소스에서 로드됩니다.

막힌
[in] 단추를 사용자 지정할 수 있는지 여부를 결정하는 부울 값입니다. 이 매개 변수가 TRUE이면 단추를 사용자 지정할 수 없습니다. 그렇지 않으면 단추를 사용자 지정할 수 있습니다.

CMFCToolBarButton::CompareWith

이 인스턴스를 제공된 CMFCToolBarButton 개체와 비교합니다.

virtual BOOL CompareWith(const CMFCToolBarButton& other) const;

매개 변수

기타
[in] 이 인스턴스와 비교할 개체에 대한 참조입니다.

Return Value

제공된 개체가 이 인스턴스의 값과 같으면 0이 아닌 경우 그렇지 않으면 0입니다.

설명

기본 구현은 제공된 개체의 명령 ID가 이 인스턴스의 명령 ID와 같은지 여부를 결정합니다. 두 CMFCToolBarButton 개체가 같은지 여부를 확인하기 위해 추가 처리를 수행해야 하는 경우 이 메서드를 재정의합니다.

CMFCToolBarButton::CopyFrom

다른 도구 모음 단추의 속성을 현재 단추에 복사합니다.

virtual void CopyFrom(const CMFCToolBarButton& src);

매개 변수

src
[in] 복사할 원본 단추에 대한 참조입니다.

설명

다른 도구 모음 단추를 이 도구 모음 단추에 복사하려면 이 메서드를 호출합니다.

CMFCToolBarButton::CreateFromOleData

제공된 CMFCToolBarButton 개체에서 개체를 COleDataObject 만듭니다.

static CMFCToolBarButton* __stdcall CreateFromOleData(COleDataObject* pDataObject);

매개 변수

pDataObject
[in] 원본 OLE 데이터 개체입니다.

Return Value

만든 CMFCToolBarButton 개체입니다.

설명

이 메서드는 프레임워크에서 다양한 형식으로 데이터 전송을 수행하는 데 사용됩니다. 예를 들어 이 메서드는 CMFCOutlookBarPane::OnDragOver 이 메서드를 사용하여 끌어서 놓기 작업을 수행합니다.

CMFCToolBarButton::EnableWindow

마우스 및 키보드 입력을 사용하거나 사용하지 않도록 설정합니다.

virtual void EnableWindow(BOOL bEnable = TRUE);

매개 변수

bEnable
[in] 입력을 사용하도록 설정하려면 이 매개 변수를 TRUE로, 입력을 사용하지 않도록 설정하려면 FALSE로 설정합니다.

설명

이 메서드는 함수를 EnableWindow 호출하여 입력을 사용하거나 사용하지 않도록 설정합니다. 자세한 내용은 Windows SDK의 EnableWindow 를 참조하세요.

CMFCToolBarButton::ExportToMenuButton

도구 모음 단추에서 메뉴로 텍스트를 복사합니다.

virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;

매개 변수

menuButton
[in] 대상 메뉴 단추에 대한 참조입니다.

Return Value

이 메서드는 TRUE를 반환합니다.

설명

프레임워크는 이 메서드를 호출하여 도구 모음 단추에서 메뉴 단추로 텍스트를 복사합니다. 기본 구현은 단추의 텍스트 레이블을 복사합니다. 텍스트 레이블이 비어 있으면 이 메서드는 단추의 도구 설명 텍스트를 복사합니다.

이 메서드의 기본 구현은 TRUE를 반환합니다. 프레임워크가 CMFCToolbarButton에서 파생된 개체를 메뉴 단추로 변환할 때 추가 작업을 수행하려는 경우 이 메서드를 재정의합니다.

CMFCToolBarButton::GetClipboardFormat

애플리케이션의 전역 클립보드 형식을 검색합니다.

static CLIPFORMAT __stdcall GetClipboardFormat();

Return Value

애플리케이션의 전역 CLIPFORMAT 값입니다.

설명

프레임워크는 이 메서드를 호출하여 OLE 데이터 전송 작업에 대한 클립보드 형식을 검색합니다. 예를 들어 CMFCToolBarButton::CreateFromOleData 메서드는 이 메서드를 사용하여 원본 OLE 데이터 개체에서 데이터를 복사합니다.

이 메서드는 이 메서드를 처음 호출할 때 전역 CLIPFORMAT 값을 설정합니다. 이 메서드에 대한 모든 후속 호출은 이 값을 반환합니다.

애플리케이션 간에 끌어서 놓기 작업이 수행되도록 하려면 CMFCToolBarButton::SetClipboardFormatName 메서드를 호출합니다.

MFC의 클립보드에 대한 자세한 내용은 클립보드를 참조하세요.

CMFCToolBarButton::GetHwnd

도구 모음 단추와 연결된 창 핸들을 검색합니다.

virtual HWND GetHwnd();

Return Value

도구 모음 단추와 연결된 창 핸들이거나, 도구 모음 단추에 연결된 창 핸들이 없는 경우 NULL입니다.

설명

이 메서드의 기본 구현은 NULL을 반환합니다. 이 메서드를 재정의하여 특정 컨트롤의 창 핸들을 반환합니다.

CMFCToolBarButton::GetImage

단추의 이미지 인덱스를 검색합니다.

int GetImage() const;

Return Value

이 단추와 연결된 이미지의 인덱스입니다.

설명

단추에 사용자 정의 이미지(즉, 생성자에서 bUserButton이 TRUE인 경우)가 있는 경우 반환된 인덱스는 사용자 정의 이미지 컬렉션에 이미지를 지정합니다(CMFCToolBar::GetUserImages 참조). 그렇지 않으면 인덱스는 리소스 파일에서 로드되는 이미지 컬렉션의 이미지를 지정합니다(CMFCToolBar::GetImages 참조). 리소스 파일에 대한 자세한 내용은 리소스 파일 작업을 참조 하세요.

CMFCToolBarButton::GetInvalidateRect

다시 그려야 하는 단추의 클라이언트 영역 영역을 검색합니다.

virtual const CRect GetInvalidateRect() const;

Return Value

CRect 다시 그려야 하는 영역을 지정하는 개체입니다.

설명

이 메서드의 기본 구현은 전체 클라이언트 영역을 반환합니다. 다른 영역을 다시 그려야 하는 경우 이 메서드를 재정의합니다.

CMFCToolBarButton::GetParentWnd

단추의 부모 창을 검색합니다.

CWnd* GetParentWnd() const;

Return Value

단추의 부모 창입니다.

CMFCToolBarButton::GetProtectedCommands

사용자가 사용자 지정할 수 없는 명령 목록을 검색합니다.

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

Return Value

보호된 명령 목록입니다.

설명

사용자 지정 모드에서 프레임워크는 보호되는 도구 모음 단추 명령을 사용하지 않도록 설정합니다. 사용자가 비활성화된 도구 모음 단추에서 끌어서 놓기 및 편집 작업을 수행할 수 없습니다.

CMFCToolBarButton::SetProtectedCommands 메서드를 사용하여 보호된 명령 목록을 정의합니다.

CMFCToolBarButton::GetTextSize

단추 텍스트의 크기를 검색합니다.

SIZE GetTextSize() const;

Return Value

단추 텍스트의 크기(픽셀)를 포함하는 SIZE 개체입니다.

CMFCToolBarButton::HasFocus

단추에 현재 입력 포커스가 있는지 여부를 확인합니다.

virtual BOOL HasFocus() const;

Return Value

단추에 입력 포커스가 있는 경우 0이 아닌 경우 그렇지 않으면 0입니다.

설명

이 메서드의 기본 구현은 단추에 입력 포커스가 있거나 입력 포커스가 있는 창의 자식 또는 하위 창인 경우 0이 아닌 값을 반환합니다. 이 함수를 재정의하여 이 동작을 사용자 지정할 수 있습니다.

CMFCToolBarButton::HaveHotBorder

사용자가 단추를 선택할 때 단추의 테두리가 표시되는지 여부를 결정합니다.

virtual BOOL HaveHotBorder() const;

Return Value

이 메서드는 TRUE를 반환합니다.

설명

프레임워크는 이 메서드를 호출하여 사용자가 선택할 때 도구 모음 단추가 테두리를 표시해야 하는지 여부를 결정합니다.

기본 구현은 TRUE를 반환합니다. 이 동작을 사용자 지정하려면 이 메서드를 재정의할 수 있습니다.

CMFCToolBarButton::IsDrawImage

단추에 이미지가 표시되는지 여부를 결정합니다.

BOOL IsDrawImage() const;

Return Value

단추에 이미지가 표시되는 경우 0이 아닌 경우 그렇지 않으면 0입니다.

설명

이 메서드는 도구 모음 단추에 연결된 이미지가 없거나(CMFCToolBarButton::GetImage가 -1을 반환) CMFCToolBarButton::m_bImage FALSE로 설정된 경우 FALSE를 반환합니다.

CMFCToolBarButton::IsDrawText

단추에 텍스트 레이블이 표시되는지 여부를 결정합니다.

BOOL IsDrawText() const;

Return Value

텍스트 레이블이 표시되는 경우 0이 아닌 경우 그렇지 않으면 0입니다.

설명

이 메서드는 도구 모음 단추에 연결된 텍스트 레이블( CMFCToolBarButton::m_strText 비어 있음) 이 없거나 CMFCToolBarButton::m_bText FALSE로 설정된 경우 FALSE를 반환합니다.

CMFCToolBarButton::IsDroppedDown

단추에 하위 메뉴가 표시되는지 여부를 결정합니다.

virtual BOOL IsDroppedDown() const;

Return Value

이 메서드는 FALSE를 반환합니다.

설명

이 메서드의 기본 구현은 FALSE를 반환합니다. 컨트롤에 하위 메뉴가 표시되는 경우 TRUE를 반환하도록 이 메서드를 재정의합니다.

CMFCToolBarButton::IsEditable

단추를 사용자 지정할 수 있는지 여부를 결정합니다.

virtual BOOL IsEditable() const;

Return Value

사용자가 단추를 사용자 지정할 수 있는 경우 0이 아닌 경우 그렇지 않으면 0입니다.

설명

프레임워크는 이 메서드를 호출하여 사용자가 끌어서 놓기 또는 편집 작업을 사용하여 도구 모음 단추를 사용자 지정할 수 있는지 여부를 결정합니다.

단추의 명령 ID가 표준 명령이거나(함수를 호출 IsStandardCommand 하여 이를 확인할 수 있음) 명령 ID가 보호된 명령 목록에 있는 경우 기본 구현은 FALSE를 반환합니다. 보호된 명령에 대한 자세한 내용은 CMFCToolBarButton::GetProtectedCommands 및 CMFCToolBarButton::SetProtectedCommands를 참조하세요.

이 메서드를 재정의하여 동작을 사용자 지정합니다.

CMFCToolBarButton::IsExtraSize

확장된 테두리를 사용하여 단추를 표시할 수 있는지 여부를 결정합니다.

virtual BOOL IsExtraSize() const;

Return Value

도구 모음 단추를 확장된 테두리로 표시할 수 있는 경우 0이 아닌 경우 그렇지 않으면 0입니다.

설명

여러 스킨이 도구 모음 단추의 테두리에 추가 크기를 사용합니다(예: 둥근 단추).

사용자가 이 단추를 한 도구 모음에서 다른 도구 모음으로 이동하는 경우 프레임워크는 CMFCToolBarButton::OnChangeParentWnd 메서드를 호출합니다. CMFCToolBarButton::OnChangeParentWnd 메서드는 추가 크기 플래그를 새 부모 도구 모음의 플래그로 설정합니다(자세한 내용은 CMFCToolBar::IsButtonExtraSizeAvailable 참조).

CMFCToolBarButton::IsFirstInGroup

단추가 단추 그룹의 첫 번째 위치에 있는지 여부를 확인합니다.

virtual BOOL IsFirstInGroup() const;

Return Value

단추가 단추 그룹의 첫 번째 단추이면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

이 메서드는 단추 그룹을 동일한 행에 배치되고 도구 모음의 테두리나 구분 기호로 경계가 지정된 인접한 단추 집합으로 정의합니다. 도구 모음 단추가 사용자 지정 단추를 참조하는 경우 이 메서드는 FALSE를 반환합니다. 사용자 지정 단추에 대한 자세한 내용은 CMFCToolBar::GetCustomizeButton을 참조 하세요.

CMFCToolBarButton::IsLastInGroup 메서드를 호출하여 단추가 단추 그룹의 마지막 위치에 있는지 확인합니다.

CMFCToolBarButton::IsHidden

단추가 숨겨져 있는지 여부를 확인합니다.

BOOL IsHidden() const;

Return Value

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

설명

프레임워크는 부모 도구 모음이 확장될 때 이 메서드를 호출하여 도구 모음 단추가 표시되는지 여부를 확인합니다.

CMFCToolBarButton::SetVisible 메서드를 사용하여 단추를 보이지 않게 설정하는 경우 CMFCToolBarButton::IsVisible을 사용하여 도구 모음 단추가 표시되는지 여부를 확인합니다.

기본적으로 모든 도구 모음 단추가 표시됩니다. CMFCToolBarButton::Show 메서드를 사용하여 도구 모음 단추를 숨기거나 표시합니다.

CMFCToolBarButton::IsHorizontal

단추가 가로 도구 모음에 있는지 여부를 결정합니다.

BOOL IsHorizontal() const;

Return Value

도구 모음 단추가 가로 도구 모음에 있는 경우 0이 아닌 경우 그렇지 않으면 0입니다.

설명

프레임워크는 이 메서드를 호출하여 도구 모음 단추의 레이아웃을 결정합니다.

이 메서드는 데이터 멤버를 반환합니다 m_bHorz . 데이터 멤버의 m_bHorz 기본값은 TRUE입니다. CMFCToolBarButton::OnDraw 메서드에 대한 각 호출에서 다시 설정됩니다.

CMFCToolBarButton::IsLastInGroup

단추가 단추 그룹의 마지막 위치에 있는지 여부를 지정합니다.

virtual BOOL IsLastInGroup() const;

Return Value

단추가 단추 그룹의 마지막 단추이면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

이 메서드는 단추 그룹을 동일한 행에 배치되고 구분 기호 또는 도구 모음의 테두리로 바인딩된 인접한 단추 집합으로 정의합니다. 이 메서드는 도구 모음 단추에 부모 도구 모음이 없거나 도구 모음 단추가 사용자 지정 단추를 참조하는 경우 FALSE를 반환합니다. 사용자 지정 단추에 대한 자세한 내용은 CMFCToolBar::GetCustomizeButton을 참조 하세요.

CMFCToolBarButton::IsFirstInGroup 메서드를 호출하여 단추가 단추 그룹의 첫 번째 위치에 있는지 확인합니다.

CMFCToolBarButton::IsLocked

단추가 잠긴(사용자 지정 불가능) 도구 모음에 있는지 여부를 확인합니다.

BOOL IsLocked() const;

Return Value

단추가 잠긴 도구 모음에 있는 경우 0이 아닌 경우 그렇지 않으면 0입니다.

설명

프레임워크는 이 메서드를 호출하여 사용자가 끌어서 놓기 또는 편집 작업을 사용하여 도구 모음 단추를 사용자 지정할 수 있는지 여부를 결정합니다. CMFCToolBar::LoadToolBar 메서드를 사용하여 부모 도구 모음에서 잠긴 특성을 설정합니다. 프레임워크는 이 특성의 값을 부모 도구 모음에 삽입하는 각 도구 모음 단추( CMFCToolbarButton)의 생성자에 전달합니다.

CMFCToolBarButton::IsOwnerOf

단추가 제공된 창 핸들의 소유자인지 여부를 확인합니다.

virtual BOOL IsOwnerOf(HWND hwnd);

매개 변수

hwnd
[in] 창 핸들입니다.

Return Value

단추가 제공된 창 핸들의 소유자인 경우 0이 아닌 경우 그렇지 않으면 0입니다.

설명

hwnd가 직접 창 핸들을 참조하거나 단추와 연결된 창 핸들의 자식인 경우 이 메서드는 0이 아닌 값을 반환합니다. hwnd가 NULL이면 이 메서드는 0을 반환합니다.

CMFCToolBarButton::IsVisible

도구 모음 단추가 표시되는지 여부를 확인합니다.

BOOL IsVisible() const;

Return Value

도구 모음 단추가 표시되는 경우 0이 아닌 경우 그렇지 않으면 0입니다.

설명

CMFCToolBarButton::SetVisible 메서드를 사용하여 도구 모음 단추를 표시하거나 숨길 수 있습니다 . CMFCToolBarButton::SetVisible을 호출한 후 부모 도구 모음에서 CPane::AdjustSizeImmediate 메서드를 호출하여 부모 도구 모음의 레이아웃을 다시 계산합니다.

CMFCToolBarButton::IsWindowVisible

단추의 기본 창 핸들이 표시되는지 여부를 확인합니다.

virtual BOOL IsWindowVisible();

Return Value

단추의 기본 창 핸들이 표시되는 경우 0이 아닌 경우 그렇지 않으면 0입니다.

설명

이 메서드는 기본 창 핸들의 스타일 특성에 WS_VISIBLE 스타일이 포함된 경우 0이 아닌 값을 반환합니다. 단추의 기본 창 핸들이 NULL인 경우 이 메서드는 FALSE를 반환합니다.

CMFCToolBarButton::m_bImage

단추에 이미지가 표시되는지 여부를 지정합니다.

BOOL m_bImage;

설명

이 데이터 멤버가 TRUE로 설정된 경우 프레임워크는 도구 모음 단추와 연결된 이미지를 표시합니다. 그렇지 않으면 프레임워크가 이미지를 표시하지 않습니다. 이 멤버는 CMFCToolBarButton::m_bImage 메서드의 반환 값에 영향을 줍니다.

CMFCToolBarButton::m_bText

단추에 텍스트 레이블이 표시되는지 여부를 지정합니다.

BOOL m_bText;

설명

이 데이터 멤버가 TRUE로 설정된 경우 프레임워크는 도구 모음 단추의 텍스트 레이블을 표시합니다. 그렇지 않으면 프레임워크에서 텍스트 레이블을 표시하지 않습니다. 이 멤버는 CMFCToolBarButton::m_bText 메서드의 반환 값에 영향을 줍니다.

CMFCToolBarButton::m_bTextBelow

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

BOOL m_bTextBelow;

설명

이 멤버 변수가 TRUE로 설정된 경우 프레임워크는 이미지 아래에 단추의 텍스트를 표시합니다. 이 멤버의 기본값은 FALSE입니다.

CMFCToolBarButton::m_bUserButton

단추에 사용자 정의 이미지가 있는지 여부를 지정합니다.

BOOL m_bUserButton;

설명

단추에 연결된 사용자 정의 이미지가 있는 경우 이 데이터 멤버는 TRUE로 설정됩니다.

CMFCToolBarButton::m_bWholeText

경계 사각형에 맞지 않더라도 단추가 전체 텍스트 레이블을 표시할지 여부를 지정합니다.

BOOL m_bWholeText;

설명

이 데이터 멤버가 TRUE로 설정된 경우 프레임워크는 단추를 확대하여 전체 텍스트 레이블을 표시합니다. 그렇지 않으면 프레임워크가 잘리고 줄임표( ...)를 텍스트 레이블에 추가합니다.

CMFCToolBarButton::m_bWrap

구분 기호 옆에 있는 단추를 다음 행에 배치할지 여부를 지정합니다.

BOOL m_bWrap;

설명

프레임워크는 도구 모음 단추가 현재 행에 맞지 않거나 레이아웃을 지정할 때(예: 행당 특정 수의 도구 모음 단추) 이 데이터 멤버를 TRUE로 설정합니다.

이 데이터 멤버가 TRUE로 설정되고 도구 모음이 가로로 도킹되거나 부동하는 경우 프레임워크는 이 단추를 다음 행에 배치합니다.

이 데이터 멤버의 기본값은 FALSE입니다.

CMFCToolBarButton::m_bWrapText

여러 줄 텍스트 레이블을 사용할 수 있는지 여부를 지정합니다.

AFX_IMPORT_DATA static BOOL m_bWrapText;

설명

이 정적 멤버 변수가 TRUE이면 프레임워크를 사용하면 모든 도구 모음이 도구 모음 단추에 여러 줄 텍스트 레이블을 표시할 수 있습니다.

이 데이터 멤버의 기본값은 FALSE입니다.

CMFCToolBarButton::m_nID

단추의 명령 ID입니다.

UINT m_nID;

설명

명령 ID -1은 단추가 구분 기호임을 나타냅니다. 모든 단추 구분 기호에는 TBBS_SEPARATOR 스타일이 있습니다. 단추 스타일에 대한 자세한 내용은 CMFCToolBarButton::m_nStyle 참조하세요.

CMFCToolBarButton::m_nStyle

단추의 스타일입니다.

UINT m_nStyle;

설명

사용 가능한 도구 모음 단추 스타일 목록은 도구 모음 컨트롤 스타일을 참조하세요.

CMFCToolBarButton::m_strText

단추의 텍스트 레이블입니다.

CString m_strText;

설명

이 데이터 멤버는 단추의 텍스트 레이블을 포함합니다. 텍스트 레이블은 비어 있을 수 있습니다.

CMFCToolBarButton::NotifyCommand

단추가 WM_COMMAND 메시지를 처리하는지 여부를 지정합니다.

virtual BOOL NotifyCommand(int iNotifyCode);

매개 변수

iNotifyCode
[in] 명령과 연결된 알림 메시지입니다.

Return Value

이 메서드는 FALSE를 반환합니다.

설명

프레임워크는 부모 창에 WM_COMMAND 메시지를 보내려고 할 때 이 메서드를 호출합니다.

기본적으로 이 메서드는 FALSE를 반환합니다. 부모 도구 모음에서 메시지를 처리해야 함을 나타내기 위해 WM_COMMAND 메시지 또는 FALSE를 처리하려는 경우 TRUE를 반환하도록 이 메서드를 재정의합니다.

CMFCToolBarButton::OnAddToCustomizePage

사용자 지정 대화 상자에 단추를 추가할 때 프레임워크에서 호출됩니다.

virtual void OnAddToCustomizePage();

설명

이 메서드의 기본 구현은 아무 작업도 수행하지 않습니다. 사용자 지정 대화 상자에 단추를 추가할 때 일부 작업을 수행하려는 경우 이 메서드를 재정의합니다.

CMFCToolBarButton::OnBeforeDrag

단추를 끌 수 있는지 여부를 지정합니다.

virtual BOOL OnBeforeDrag() const;

Return Value

단추를 끌 수 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

프레임워크는 사용자가 단추를 끌기 시작하기 전에 이 메서드를 호출합니다.

이 메서드의 기본 구현은 TRUE를 반환합니다. 단추 끌기를 사용하지 않도록 설정하려면 FALSE를 반환하도록 이 메서드를 재정의합니다.

CMFCToolBarButton::OnBeforeDrop

사용자가 대상 도구 모음에 단추를 놓을 수 있는지 여부를 지정합니다.

virtual BOOL OnBeforeDrop(CMFCToolBar* pTarget);

매개 변수

pTarget
[in] 끌어서 놓기 작업의 대상입니다.

Return Value

제공된 대상 도구 모음에 단추를 놓을 수 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

프레임워크는 단추를 도구 모음에 놓기 전에 이 메서드를 호출합니다.

이 메서드의 기본 구현은 TRUE를 반환합니다. 지정된 대상에서 놓기 작업을 사용하지 않도록 설정하려면 FALSE를 반환하도록 이 메서드를 재정의합니다.

CMFCToolBarButton::OnCalculateSize

프레임워크에서 지정된 디바이스 컨텍스트 및 도킹 상태에 대한 단추 크기를 계산하기 위해 호출됩니다.

virtual SIZE OnCalculateSize(
    CDC* pDC,
    const CSize& sizeDefault,
    BOOL bHorz);

매개 변수

pDC
[in] 단추를 표시하는 디바이스 컨텍스트입니다.

sizeDefault
[in] 단추의 기본 크기입니다.

bHorz
[in] 부모 도구 모음의 도킹 상태입니다. 이 매개 변수는 도구 모음이 가로로 도킹되거나 부동하는 경우 TRUE이고, 도구 모음이 세로로 도킹된 경우 FALSE입니다.

Return Value

SIZE 단추의 크기를 픽셀 단위로 포함하는 구조체입니다.

설명

프레임워크는 이 메서드를 호출하여 지정된 디바이스 컨텍스트 및 도크 상태에 대한 도구 모음 단추의 크기를 결정합니다.

기본 구현에서는 텍스트 및 이미지 크기(표시되는 경우), 텍스트 및 이미지 위치(이미지의 아래 또는 오른쪽에 있는 텍스트) 및 도구 모음 도킹 상태를 고려합니다.

비표준 단추의 크기(예: 편집 상자 단추)를 제공하려는 경우 이 메서드를 재정의합니다.

CMFCToolBarButton::OnCancelMode

WM_CANCELMODE 메시지를 처리하기 위해 프레임워크에서 호출됩니다.

virtual void OnCancelMode();

설명

이 메서드의 기본 구현은 아무 작업도 수행하지 않습니다. WM_CANCELMODE 메시지를 처리하려는 경우 이 메서드를 재정의합니다.

CMFCToolBarButton::OnChangeParentWnd

단추가 새 도구 모음에 삽입될 때 프레임워크에서 호출됩니다.

virtual void OnChangeParentWnd(CWnd* pWndParent);

매개 변수

pWndParent
[in] 새 부모 창입니다.

설명

예를 들어 사용자가 도구 모음을 한 도구 모음에서 다른 도구 모음으로 끌 때 단추가 도구 모음에 삽입됩니다.

이 메서드의 기본 구현은 아무 작업도 수행하지 않습니다.

CMFCToolBarButton::OnClick

사용자가 마우스 단추를 클릭할 때 프레임워크에서 호출됩니다.

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay=TRUE);

매개 변수

pWnd
[in] 도구 모음 단추의 부모 창입니다.

bDelay
[in] 메시지를 지연으로 처리해야 하는 경우 TRUE입니다.

Return Value

이 메서드는 FALSE를 반환합니다.

설명

프레임워크는 사용자가 도구 모음 단추를 클릭할 때 이 메서드를 호출합니다.

기본 구현은 아무 것도 수행하지 않으며 FALSE를 반환합니다. 단추가 클릭 메시지를 처리하는 경우 0이 아닌 값을 반환하도록 이 메서드를 재정의합니다.

CMFCToolBarButton::OnClickUp

사용자가 마우스 단추를 놓을 때 프레임워크에서 호출됩니다.

virtual BOOL OnClickUp();

Return Value

이 메서드는 FALSE를 반환합니다.

설명

프레임워크는 사용자가 도구 모음 단추를 해제할 때 이 메서드를 호출합니다.

기본 구현은 아무 것도 수행하지 않으며 FALSE를 반환합니다. 단추가 클릭 메시지를 처리하는 경우 0이 아닌 값을 반환하도록 이 메서드를 재정의합니다.

CMFCToolBarButton::OnContextHelp

부모 도구 모음이 WM_HELPHITTEST 메시지를 처리할 때 프레임워크에서 호출됩니다.

virtual BOOL OnContextHelp(CWnd* pWnd);

매개 변수

pWnd
[in] 도구 모음 단추의 부모 창입니다.

Return Value

이 메서드는 FALSE를 반환합니다.

설명

이 메서드의 기본 구현은 아무 작업도 수행하지 않으며 FALSE를 반환합니다. 단추가 도움말 메시지를 처리하는 경우 0이 아닌 값을 반환하도록 이 메서드를 재정의합니다.

WM_HELPHITTEST 메시지에 대한 자세한 내용은 TN028: 상황에 맞는 도움말 지원을 참조 하세요.

CMFCToolBarButton::OnCtlColor

부모 도구 모음이 WM_CTLCOLOR 메시지를 처리할 때 프레임워크에서 호출됩니다.

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

매개 변수

pDC
[in] 단추를 표시하는 디바이스 컨텍스트입니다.

nCtlColor
[in] 특정 색 알림입니다.

Return Value

프레임워크가 단추의 배경을 그리는 데 사용하는 브러시 개체에 대한 핸들입니다.

설명

프레임워크는 부모 도구 모음이 Windows 컨트롤이 포함된 도구 모음 단추에 대한 WM_CTLCOLOR 메시지를 처리할 때 이 메서드를 호출합니다. 도구 모음 단추가 창이 없는 경우 프레임워크에서 이 메서드를 호출하지 않습니다.

프레임워크는 도구 모음 프레임워크가 사용자 지정 모드이고 도구 모음 단추의 잠금이 해제된 경우 이 메서드를 호출합니다. 사용자 지정 모드에 대한 자세한 내용은 CMFCToolBar::SetCustomizeMode를 참조하세요. 도구 모음 단추 잠금에 대한 자세한 내용은 CMFCToolBarButton::IsLocked을 참조하세요.

기본 구현은 아무 것도 수행하지 않으며 NULL을 반환합니다.

CMFCToolBarButton::OnCustomizeMenu

응용 프로그램이 부모 도구 모음에 바로 가기 메뉴를 표시할 때 단추가 제공된 메뉴를 수정할 수 있도록 합니다.

virtual BOOL OnCustomizeMenu(CMenu* pMenu);

매개 변수

pMenu
[in] 사용자 지정할 메뉴입니다.

Return Value

이 메서드는 FALSE를 반환합니다.

설명

기본 구현은 아무 것도 수행하지 않으며 FALSE를 반환합니다. 제공된 메뉴의 내용을 수정하려면 이 메서드를 재정의하고 0이 아닌 값을 반환합니다.

CMFCToolBarButton::OnDblClk

부모 도구 모음이 WM_LBUTTONDBLCLK 메시지를 처리할 때 프레임워크에서 호출됩니다.

virtual void OnDblClk(CWnd* pWnd);

매개 변수

pWnd
[in] - 단추의 부모 창입니다.

설명

이 메서드는 부모 도구 모음에서 CMFCToolBar::OnLButtonDblClk WM_LBUTTONDBLCLK 메시지를 처리할 때 메서드에서 호출됩니다.

이 메서드의 기본 구현은 아무 작업도 수행하지 않습니다.

CMFCToolBarButton::OnDraw

지정된 스타일 및 옵션을 사용하여 단추를 그리기 위해 프레임워크에서 호출됩니다.

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    CMFCToolBarImages* pImages,
    BOOL bHorz=TRUE,
    BOOL bCustomizeMode=FALSE,
    BOOL bHighlight=FALSE,
    BOOL bDrawBorder=TRUE,
    BOOL bGrayDisabledButtons=TRUE);

매개 변수

pDC
[in] 단추를 표시하는 디바이스 컨텍스트입니다.

rect
[in] 단추의 경계 사각형입니다.

pImages
[in] 단추와 연결된 도구 모음 이미지의 컬렉션입니다.

bHorz
[in] 부모 도구 모음의 도킹 상태입니다. 이 매개 변수는 단추가 가로로 도킹된 경우 TRUE이고 단추가 세로로 도킹되면 FALSE입니다.

bCustomizeMode
[in] 도구 모음이 사용자 지정 모드인지 여부를 지정합니다. 이 매개 변수는 도구 모음이 사용자 지정 모드에 있는 경우 TRUE이고 도구 모음이 사용자 지정 모드가 아닌 경우 FALSE입니다.

bHighlight
[in] 단추가 강조 표시되는지 여부를 지정합니다. 이 매개 변수는 단추가 강조 표시된 경우 TRUE이고 단추가 강조 표시되지 않으면 FALSE입니다.

bDrawBorder
[in] 단추에 테두리를 표시할지 여부를 지정합니다. 이 매개 변수는 단추가 테두리를 표시해야 하는 경우 TRUE이고 단추에 테두리가 표시되지 않아야 하는 경우 FALSE입니다.

bGrayDisabledButtons
[in] 비활성화된 단추를 음영 처리할지 또는 비활성화된 이미지 컬렉션을 사용할지 여부를 지정합니다. 이 매개 변수는 비활성화된 단추를 음영 처리해야 하는 경우 TRUE이고, 이 메서드에서 사용할 수 없는 이미지 컬렉션을 사용해야 하는 경우 FALSE입니다.

설명

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

CMFCToolBarButton::OnDrawOnCustomizeList

사용자 지정 대화 상자의 명령 창에서 단추를 그리기 위해 프레임워크에서 호출됩니다.

virtual int OnDrawOnCustomizeList(
    CDC* pDC,
    const CRect& rect,
    BOOL bSelected);

매개 변수

pDC
[in] 단추를 표시하는 디바이스 컨텍스트입니다.

rect
[in] 단추의 경계 사각형입니다.

bSelected
[in] 단추를 선택할지 여부를 지정합니다. 이 매개 변수가 TRUE이면 단추가 선택됩니다. 이 매개 변수가 FALSE이면 단추가 선택되지 않습니다.

Return Value

지정된 디바이스 컨텍스트에 있는 단추의 너비(픽셀)입니다.

설명

이 메서드는 사용자 지정 대화 상자( 명령 탭)에서 단추를 소유자 그리기 목록 상자에 표시하려고 할 때 호출됩니다.

이 메서드의 기본 구현은 사용 가능한 경우 단추의 이미지 및 텍스트 레이블을 표시합니다. 단추의 텍스트 레이블을 사용할 수 없는 경우 메서드는 도구 설명 텍스트를 표시합니다.

사용자 지정 그리기를 수행하려면 이 메서드를 재정의합니다.

CMFCToolBarButton::OnGetCustomToolTipText

단추에 대한 사용자 지정 도구 설명 텍스트를 검색하기 위해 프레임워크에서 호출됩니다.

virtual BOOL OnGetCustomToolTipText(CString& strToolTip);

매개 변수

strToolTip
[out] CString 사용자 지정 도구 설명 텍스트를 받는 개체입니다.

Return Value

이 메서드는 FALSE를 반환합니다.

설명

프레임워크는 도구 모음 단추에 대한 도구 설명을 표시할 때 이 메서드를 호출합니다. 이 메서드가 FALSE를 반환하는 경우 프레임워크는 기본 도구 설명을 사용합니다.

기본 구현은 아무 것도 수행하지 않으며 FALSE를 반환합니다. 이 메서드를 재정의하고 0이 아닌 값을 반환하여 도구 모음 단추에 대한 사용자 지정 도구 설명 텍스트를 제공합니다.

CMFCToolBarButton::OnGlobalFontsChanged

전역 글꼴이 변경되면 프레임워크에서 호출됩니다.

virtual void OnGlobalFontsChanged();

설명

이 메서드의 기본 구현은 아무 작업도 수행하지 않습니다. 단추 텍스트를 표시하는 데 사용되는 글꼴을 업데이트하려면 이 메서드를 재정의합니다.

CMFCToolBarButton::OnMove

부모 도구 모음이 이동할 때 프레임워크에서 호출됩니다.

virtual void OnMove();

설명

이 메서드의 기본 구현은 아무 작업도 수행하지 않습니다. 부모 도구 모음이 이동할 때 단추의 위치를 변경하려면 이 메서드를 재정의합니다.

CMFCToolBarButton::OnShow

단추가 표시되거나 보이지 않는 경우 프레임워크에서 호출됩니다.

virtual void OnShow(BOOL bShow);

매개 변수

bShow
[in] 단추가 표시되는지 여부를 지정합니다. 이 매개 변수가 TRUE이면 단추가 표시됩니다. 그렇지 않으면 단추가 표시되지 않습니다.

설명

이 메서드의 기본 구현은 아무 작업도 수행하지 않습니다. 단추의 표시 여부를 업데이트하려면 이 메서드를 재정의합니다.

CMFCToolBarButton::OnSize

부모 도구 모음이 크기 또는 위치를 변경하고 이 변경으로 인해 단추의 크기가 변경되면 프레임워크에서 호출됩니다.

virtual void OnSize(int iSize);

매개 변수

iSize
[in] 단추의 새 너비입니다.

설명

이 메서드의 기본 구현은 아무 작업도 수행하지 않습니다. 부모 도구 모음의 크기 또는 위치가 변경되면 단추 크기를 조정하려면 이 메서드를 재정의합니다.

CMFCToolBarButton::OnToolHitTest

부모 도구 모음에서 단추의 경계 사각형에 점이 있는지 여부를 결정해야 하는 경우 프레임워크에서 호출됩니다.

virtual BOOL OnToolHitTest(
    const CWnd* pWnd,
    TOOLINFO* pTI);

매개 변수

pWnd
[in] 단추의 부모 창입니다. NULL일 수 있습니다.

pTI
[in] TOOLINFO 도구 설명 컨트롤의 도구에 대한 정보가 들어 있는 구조체입니다.

Return Value

단추가 부모 프레임 창에 대한 포인터를 검색할 수 있으면 결과 OnMenuButtonToolHitTest 입니다. 그렇지 않으면 FALSE입니다.

설명

이 메서드는 부모 창을 유효한 프레임 개체로 변환할 수 있는 경우 다음 메서드 중 하나를 호출합니다.

CMFCToolBarButton::OnUpdateToolTip

부모 도구 모음이 도구 설명 텍스트를 업데이트할 때 프레임워크에서 호출됩니다.

virtual BOOL OnUpdateToolTip(
    CWnd* pWndParent,
    int iButtonIndex,
    CToolTipCtrl& wndToolTip,
    CString& str);

매개 변수

pWndParent
[in] 부모 창입니다.

iButtonIndex
[in] 부모 단추 컬렉션에 있는 단추의 인덱스(0부터 시작)입니다.

wndToolTip
[in] 도구 설명 텍스트를 표시하는 컨트롤입니다.

str
[out] CString 업데이트된 도구 설명 텍스트를 받는 개체입니다.

Return Value

이 메서드는 FALSE를 반환합니다.

설명

이 메서드의 기본 구현은 아무 작업도 수행하지 않으며 FALSE를 반환합니다. 도구 설명 텍스트 문자열을 제공하는 경우 0이 아닌 값을 반환하도록 이 메서드를 재정의합니다.

CMFCToolBarButton::P repareDrag

단추가 끌어서 놓기 작업을 수행하려고 할 때 프레임워크에서 호출됩니다.

virtual BOOL PrepareDrag(COleDataSource& srcItem);

매개 변수

srcItem
[in] COleDataSource 끌어서 놓기 작업에 대한 상태 정보를 저장하는 개체입니다.

Return Value

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

설명

프레임워크는 이 메서드를 호출하여 제공된 COleDataSource 개체에 상태를 저장할 도구 모음 단추를 준비합니다. 이 메서드는 공유 파일에 직렬화한 다음 해당 파일을 COleDataSource::CacheGlobalData 메서드에 전달하여 상태를 저장합니다. 도구 모음 단추 serialization에 대한 자세한 내용은 CMFCToolBarButton::Serialize를 참조 하세요.

이 메서드는 아무 작업도 수행하지 않으며 단추를 저장할 수 없는 경우 TRUE를 반환합니다( CMFCToolBarButton::CanBeStored 메서드는 FALSE를 반환합니다). 개체 serialization 중에 예외가 발생하면 FALSE를 반환합니다.

OLE 끌어서 놓기 작업에 대한 자세한 내용은 OLE 끌어서 놓기 작업을 참조 하세요.

CMFCToolBarButton::Rect

단추의 경계 사각형을 검색합니다.

const CRect& Rect() const;

Return Value

CRect 단추의 경계 사각형이 들어 있는 개체입니다.

CMFCToolBarButton::ResetImageToDefault

단추와 연결된 이미지의 기본값으로 설정합니다.

virtual void ResetImageToDefault();

설명

이 메서드는 CMFCToolBar::GetDefaultImage 메서드를 사용하여 부모 도구 모음에서 기본 이미지를 검색합니다. 단추에 연결된 기본 이미지가 없는 경우 이 메서드는 CStringT::LoadString 메서드를 사용하여 해당 문자열 리소스에 따라 단추의 텍스트 레이블을 설정합니다. 문자열 리소스에 대한 자세한 내용은 리소스 파일 작업을 참조하세요.

단추에 사용자 정의 이미지가 있는 경우 이 메서드는 아무 작업도 수행하지 않습니다.

CMFCToolBarButton::SaveBarState

도구 모음 단추의 상태를 저장합니다.

virtual void SaveBarState();

설명

프레임워크는 끌어서 놓기 작업의 결과로 개체를 CMFCToolBarButton 만들 때 이 메서드를 호출합니다.

이 메서드의 기본 구현은 아무 작업도 수행하지 않습니다. 도구 모음 단추의 상태를 외부 데이터 원본에 저장하려면 이 메서드를 재정의합니다.

CMFCToolBarButton::Serialize

보관 파일에서 이 개체를 읽거나 보관 파일에 씁니다.

virtual void Serialize(CArchive& ar);

매개 변수

ar
[in] CArchive serialize할 개체 또는 직렬화할 개체입니다.

설명

이 메서드는 클립보드 또는 끌어서 놓기 작업과 같은 데이터 전송 프로세스를 지원합니다. 제공된 개체에서 또는 제공된 CArchive 개체의 ID, 텍스트 레이블 및 이미지 ID와 같은 단추의 속성을 읽거나 씁니다.

serialization 예제는 Serialization: 개체 직렬화를 참조 하세요.

CMFCToolBarButton::SetACCData

제공된 개체를 CAccessibilityData 도구 모음 단추의 접근성 데이터로 채웁니다.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

매개 변수

pParent
[in] 도구 모음 단추의 부모 창입니다.

data
[in] CAccessibilityData 도구 모음 단추의 접근성 데이터로 채워진 개체입니다.

Return Value

이 메서드는 TRUE를 반환합니다.

설명

도구 모음 단추가 접근성 데이터를 제공하지 않는 경우 FALSE를 반환하도록 이 메서드를 재정의합니다.

CMFCToolBarButton::SetClipboardFormatName

전역 클립보드 형식의 이름을 바꿉니다.

static void __stdcall SetClipboardFormatName(LPCTSTR lpszName);

매개 변수

lpszName
[in] 전역 클립보드 형식의 새 이름입니다. NULL일 수 없습니다.

설명

이 메서드를 사용하면 여러 애플리케이션 간에 끌어서 놓기 작업이 발생할 수 있습니다. 각 애플리케이션은 동일한 클립보드 형식 이름을 제공해야 합니다.

프레임워크에서 CMFCToolBarButton::GetClipboardFormat을 호출하기 전에 이 메서드를 호출해야 합니다.

CMFCToolBarButton::SetImage

단추의 이미지 인덱스 설정

virtual void SetImage(int iImage);

매개 변수

iImage
[in] 도구 모음 이미지 컬렉션에 있는 이미지의 인덱스입니다.

설명

도구 모음 단추가 구분 기호 인 경우 iImage 는 구분 기호 단추의 새 너비를 나타냅니다.

iImage가 0보다 작은 경우 이 메서드는 이미지 그리기를 사용하지 않도록 설정하고 단추의 텍스트 레이블 그리기를 사용하도록 설정합니다.

CMFCToolBarButton::SetProtectedCommands

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

static void SetProtectedCommands(const CList<UINT,UINT>& lstCmds);

매개 변수

lstCmds
[in] 보호된 명령 목록입니다.

설명

사용자 지정 모드에서 프레임워크는 보호되는 도구 모음 단추 명령을 사용하지 않도록 설정합니다. 사용자가 비활성화된 도구 모음 단추에서 끌어서 놓기 및 편집 작업을 수행할 수 없습니다.

CMFCToolBarButton::GetProtectedCommands 메서드를 사용하여 보호된 명령 목록을 검색합니다.

CMFCToolBarButton::SetRadio

단추가 선택된 상태를 변경할 때 프레임워크에서 호출됩니다.

virtual void SetRadio();

설명

이 메서드의 기본 구현은 아무 작업도 수행하지 않습니다. 단추가 선택된 상태를 변경할 때 사용자 지정 작업을 수행하도록 이 메서드를 재정의합니다.

CMFCToolBarButton::SetRect

단추의 경계 사각형을 설정합니다.

void SetRect(const CRect rect);

매개 변수

rect
[in] 단추의 새 경계 사각형입니다.

설명

이 메서드는 새 경계 사각형을 설정한 후 CMFCToolBarButton::OnMove 메서드를 호출합니다.

CMFCToolBarButton::SetStyle

단추의 스타일을 설정합니다.

virtual void SetStyle(UINT nStyle);

매개 변수

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

설명

기본 구현에서는 CMFCToolBarButton::m_nStyle 데이터 멤버를 nStyle로 설정합니다. 스타일 변경을 처리하기 위해 추가 처리를 수행하려는 경우 이 메서드를 재정의합니다. 유효한 스타일 플래그 목록은 도구 모음 컨트롤 스타일을 참조하세요.

CMFCToolBarButton::SetVisible

단추가 표시되는지 여부를 지정합니다.

void SetVisible(BOOL bShow=TRUE);

매개 변수

bShow
[in] 단추를 표시할지 숨길지 여부를 지정하는 부울 값입니다. 이 매개 변수가 TRUE이면 단추가 표시됩니다. 매개 변수가 FALSE이면 단추가 숨겨집니다.

설명

이 함수를 사용하여 특정 도구 모음 단추를 숨기거나 표시합니다. 이 메서드를 호출한 후 CPane::AdjustSizeImmediate 메서드를 호출합니다.

CMFCToolBarButton::Show

버튼을 표시하거나 숨깁니다.

void Show(BOOL bShow);

매개 변수

bShow
[in] 단추를 표시할지 숨길지 여부를 지정하는 부울 값입니다. 이 매개 변수가 TRUE이면 단추가 표시됩니다. 매개 변수가 FALSE이면 단추가 숨겨집니다.

설명

프레임워크는 부모 도구 모음의 크기를 조정할 때 도구 모음 단추의 표시 유형을 업데이트하기 위해 이 메서드를 호출합니다. 프레임워크는 단추가 도구 모음의 범위 내에 더 이상 맞지 않을 때 bShow가 FALSE로 설정된 상태에서 이 메서드를 호출합니다. 프레임워크는 단추 크기를 다시 조정한 후 도구 모음의 범위 내에 맞으면 bShow가 TRUE로 설정된 상태에서 이 메서드를 호출합니다.

CMFCToolBarButton::SetVisible 메서드를 사용하여 단추의 일반적인 표시 유형을 설정합니다.

이 메서드는 단추의 표시 상태를 업데이트한 후 CMFCToolBarButton::OnShow 메서드를 호출합니다.

참고 항목

계층 구조 차트
클래스
CMFCToolBar 클래스
CMFCToolBarImages 클래스