CMFCCaptionBar 클래스

아티클
06/10/2015

A CMFCCaptionBar 개체는 세 가지 요소를 표시할 수 있는 컨트롤 막대: 단추, 텍스트 레이블 및 비트맵. 그는 한 번에 각 형식의 요소가 하나씩만 표시할 수 있습니다. 각 요소는 컨트롤의 왼쪽 또는 오른쪽 가장자리 또는 가운데에 맞출 수 있습니다. 평면 또는 3D 스타일 캡션 표시줄의 위쪽 및 아래쪽 테두리를 적용할 수도 있습니다.

class CMFCCaptionBar : public CPane

Members

Public 메서드

이름	설명
CMFCCaptionBar::Create	캡션 표시줄 컨트롤을 만들고 연결 하는 CMFCCaptionBar 개체입니다.
CMFCCaptionBar::DoesAllowDynInsertBefore	다른 창 동적으로 상위 프레임의 캡션 표시줄 사이의 삽입 가능 여부를 나타냅니다. (재정의 CBasePane::DoesAllowDynInsertBefore.)
CMFCCaptionBar::EnableButton	캡션 표시줄에 단추를 사용할 수 있거나.
CMFCCaptionBar::GetAlignment	지정 된 요소의 맞춤을 반환합니다.
CMFCCaptionBar::GetBorderSize	캡션 표시줄의 테두리 크기를 반환합니다.
CMFCCaptionBar::GetButtonRect	단추 캡션 표시줄의 경계 사각형을 검색합니다.
CMFCCaptionBar::GetMargin	캡션 표시줄 컨트롤의 가장자리와 캡션 표시줄 요소의 가장자리 사이의 거리를 반환합니다.
CMFCCaptionBar::IsMessageBarMode	캡션 표시줄 메시지 표시줄 모드에 있는지 여부를 지정 합니다.
CMFCCaptionBar::RemoveBitmap	비트맵 이미지는 캡션 표시줄에서 제거합니다.
CMFCCaptionBar::RemoveButton	캡션 표시줄에서 단추를 제거합니다.
CMFCCaptionBar::RemoveIcon	캡션 표시줄에서 아이콘을 제거합니다.
CMFCCaptionBar::RemoveText	텍스트 레이블 캡션 표시줄에서 제거합니다.
CMFCCaptionBar::SetBitmap	캡션 표시줄에 대 한 비트맵 이미지를 설정합니다.
CMFCCaptionBar::SetBorderSize	캡션 표시줄의 테두리 크기를 설정합니다.
CMFCCaptionBar::SetButton	캡션 표시줄에 단추를 설정합니다.
CMFCCaptionBar::SetButtonPressed	단추가 눌린 상태로 있는지 여부를 지정 합니다.
CMFCCaptionBar::SetButtonToolTip	단추에 대 한 도구 설명을 설정합니다.
CMFCCaptionBar::SetFlatBorder	캡션 표시줄의 테두리 스타일을 설정합니다.
CMFCCaptionBar::SetIcon	캡션 표시줄에 아이콘을 설정합니다.
CMFCCaptionBar::SetImageToolTip	이미지 캡션 표시줄에 대 한 도구 설명을 설정합니다.
CMFCCaptionBar::SetMargin	캡션 표시줄 컨트롤의 가장자리와 캡션 표시줄 요소의 가장자리 사이의 거리를 설정합니다.
CMFCCaptionBar::SetText	캡션 표시줄에 대 한 텍스트 레이블을 설정합니다.

Protected 메서드

이름	설명
CMFCCaptionBar::OnDrawBackground	캡션 표시줄의 배경을 채우는 데 프레임 워크에 의해 호출 됩니다.
CMFCCaptionBar::OnDrawBorder	캡션 표시줄의 테두리를 그리려면 프레임 워크에 의해 호출 됩니다.
CMFCCaptionBar::OnDrawButton	캡션 표시줄 단추를 그리려면 프레임 워크에 의해 호출 됩니다.
CMFCCaptionBar::OnDrawImage	캡션 표시줄 이미지를 그릴 때 프레임 워크에 의해 호출 됩니다.
CMFCCaptionBar::OnDrawText	캡션 표시줄 텍스트를 그리려면 프레임 워크에 의해 호출 됩니다.

데이터 멤버

이름	설명
CMFCCaptionBar::m_clrBarBackground	캡션 표시줄의 배경색입니다.
CMFCCaptionBar::m_clrBarBorder	캡션 표시줄의 테두리 색입니다.
CMFCCaptionBar::m_clrBarText	캡션 표시줄 텍스트의 색입니다.

설명

캡션 표시줄을 만들려면 다음과이 같이 하십시오.

생성 된 CMFCCaptionBar 개체입니다. 일반적으로 프레임 창 클래스에 캡션 표시줄을 추가 합니다.
호출 된 CMFCCaptionBar::Create 캡션 표시줄 컨트롤을 작성 하 고 여기에 연결 하는 CMFCCaptionBar 개체.
호출 CMFCCaptionBar::SetButton, CMFCCaptionBar::SetText, CMFCCaptionBar::SetIcon, 및 CMFCCaptionBar::SetBitmap 캡션 표시줄 요소를 설정 합니다.

Button 요소를 설정 하는 경우 단추의 명령 ID를 할당 해야 합니다. 캡션 표시줄 경로 단추를 클릭할 때 사용자의 WM_COMMAND 부모 프레임 창에이 ID를 가진 메시지입니다.

캡션 표시줄 에뮬레이션 2007 Microsoft Office 응용 프로그램에서 표시 되는 메시지 표시줄 메시지 표시줄 모드에서 작업할 수도 있습니다. 비트맵, 메시지, 및 일반적으로 대화 상자를 엽니다.)는 단추 (메시지 표시줄 모드에서 캡션 표시줄 표시 됩니다. 비트맵을 도구 설명을 지정할 수 있습니다.

메시지 표시줄 모드를 사용 하려면 호출 CMFCCaptionBar::Create 네 번째 매개 변수 (bIsMessageBarMode)로 설정 하 고 TRUE.

예제

다음 예제에서는 다양 한 메서드를 사용 하는 CMFCCaptionBar 클래스입니다. 캡션 표시줄 컨트롤을 만드는, 캡션 표시줄에 3D 테두리를 설정, 캡션 표시줄 컨트롤의 가장자리와 캡션 표시줄 요소 가장자리 사이의 픽셀 거리를 설정, 캡션 표시줄에 단추를 설정, 단추에 대 한 도구 설명을 설정, 캡션 표시줄에 대 한 텍스트 레이블을 설정, 캡션 표시줄에 대 한 비트맵 이미지를 설정 하는 예제를 보여 줍니다.및 캡션 표시줄에는 이미지의 도구 설명을 설정 합니다. 이 코드의 일부인의 MS Office 2007 데모 샘플.

   CMFCCaptionBar m_wndMessageBar;


...


BOOL CMainFrame::CreateMessageBar()
{
    // The this pointer points to a CMainFrame class which extends the CFrameWndEx class. 
    if (!m_wndMessageBar.Create(WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS, this, ID_VIEW_MESSAGEBAR, -1, TRUE))
    {
        TRACE0("Failed to create caption bar\n");
        return FALSE;
    }

    m_wndMessageBar.SetFlatBorder( FALSE );
    m_wndMessageBar.SetMargin(10);
    m_wndMessageBar.SetButton(_T("Options..."), ID_TOOLS_OPTIONS, CMFCCaptionBar::ALIGN_LEFT, FALSE);
    m_wndMessageBar.SetButtonToolTip(_T("Click here to see more options"));

    m_wndMessageBar.SetText(_T("Welcome to the MFC MSOffice2007 demonstration!"), CMFCCaptionBar::ALIGN_LEFT);

    m_wndMessageBar.SetBitmap(IDB_INFO, RGB(255, 255, 255), FALSE, CMFCCaptionBar::ALIGN_LEFT);
    m_wndMessageBar.SetImageToolTip(_T("Important"), _T("Please take a look at MSOffice2007Demo source code to learn how to create advanced user interface in minutes."));

    return TRUE;
}