CMFCCaptionBar 클래스

아티클
02/21/2013

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;
}