다음을 통해 공유


CReBar 클래스

rebar 컨트롤의 레이아웃, 지속성 및 상태 정보를 제공하는 컨트롤 막대입니다.

구문

class CReBar : public CControlBar

멤버

공용 메서드

이름 설명
CReBar::AddBar 철근에 밴드를 추가합니다.
CReBar::Create Rebar 컨트롤을 만들어 개체에 CReBar 연결합니다.
CReBar::GetReBarCtrl 기본 공용 컨트롤에 직접 액세스할 수 있습니다.

설명

Rebar 개체에는 편집 상자, 도구 모음 및 목록 상자를 비롯한 다양한 자식 창( 일반적으로 다른 컨트롤)이 포함될 수 있습니다. rebar 개체는 지정된 비트맵 위에 자식 창을 표시할 수 있습니다. 애플리케이션은 자동으로 리바 크기를 조정할 수 있습니다. 또는 사용자가 해당 그리퍼 막대를 클릭하거나 끌어서 다시 표시줄의 크기를 수동으로 조정할 수 있습니다.

RebarMenu의 예입니다.

Rebar Control

rebar 개체는 도구 모음 개체와 유사하게 동작합니다. 철근은 클릭 및 끌기 메커니즘을 사용하여 대역 크기를 조정합니다. rebar 컨트롤은 그리퍼 막대, 비트맵, 텍스트 레이블 및 자식 창이 조합된 하나 이상의 밴드를 포함할 수 있습니다. 그러나 밴드는 둘 이상의 자식 창을 포함할 수 없습니다.

CReBar 에서는 CReBarCtrl 클래스를 사용하여 구현을 제공합니다. GetReBarCtrl을 통해 Rebar 컨트롤에 액세스하여 컨트롤의 사용자 지정 옵션을 활용할 수 있습니다. Rebar 컨트롤에 대한 자세한 내용은 다음을 참조하세요 CReBarCtrl. Rebar 컨트롤 사용에 대한 자세한 내용은 CReBarCtrl 사용을 참조 하세요.

주의

Rebar 및 rebar 컨트롤 개체는 MFC 컨트롤 바 도킹을 지원하지 않습니다. CRebar::EnableDocking 호출되면 애플리케이션이 어설션됩니다.

상속 계층 구조

CObject

CCmdTarget

CWnd

CControlBar

CReBar

요구 사항

헤더: afxext.h

CReBar::AddBar

이 멤버 함수를 호출하여 리바에 밴드를 추가합니다.

BOOL AddBar(
    CWnd* pBar,
    LPCTSTR pszText = NULL,
    CBitmap* pbmp = NULL,
    DWORD dwStyle = RBBS_GRIPPERALWAYS | RBBS_FIXEDBMP);

BOOL AddBar(
    CWnd* pBar,
    COLORREF clrFore,
    COLORREF clrBack,
    LPCTSTR pszText = NULL,
    DWORD dwStyle = RBBS_GRIPPERALWAYS);

매개 변수

pBar
리바에 CWnd 삽입할 자식 창인 개체에 대한 포인터입니다. 참조된 개체에는 WS_CHILD 있어야 합니다.

lpszText
철근에 표시할 텍스트가 포함된 문자열에 대한 포인터입니다. 기본적으로 NULL입니다. lpszText포함된 텍스트는 자식 창의 일부가 아니며, 다시 표시줄 자체에 있습니다.

pbmp
철근 배경에 표시할 개체에 대한 포인터 CBitmap 입니다. 기본적으로 NULL입니다.

dwStyle
철근에 적용할 스타일이 포함된 DWORD입니다. fStyle 밴드 스타일의 전체 목록은 Win32 구조체 REBARBANDINFO의 함수 설명을 참조하세요.

clrFore
철근의 전경색을 나타내는 COLORREF 값입니다.

clrBack
철근의 배경색을 나타내는 COLORREF 값입니다.

Return Value

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

예시

// Define a CRebar in your class definition,
// such as: CReBar m_wndReBar;
m_wndReBar.Create(this);
m_wndDlgBar.Create(this, IDD_DIALOGBAR, CBRS_ALIGN_TOP,
                   IDD_DIALOGBAR);
m_wndReBar.AddBar(&m_wndDlgBar);

CReBar::Create

이 멤버 함수를 호출하여 rebar를 만듭니다.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle = RBS_BANDBORDERS,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS | WS_CLIPCHILDREN | CBRS_TOP,
    UINT nID = AFX_IDW_REBAR);

매개 변수

pParentWnd
Windows 창이 상태 표시줄의 CWnd 부모인 개체에 대한 포인터입니다. 일반적으로 프레임 창입니다.

dwCtrlStyle
철근 컨트롤 스타일입니다. 기본적으로 RBS_BANDBORDERS rebar 컨트롤 내에서 인접한 밴드를 구분하는 좁은 선을 표시합니다. 스타일 목록은 Windows SDK의 Rebar 컨트롤 스타일을 참조하세요.

dwStyle
철근 창 스타일입니다.

nID
Rebar의 자식 창 ID입니다.

Return Value

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

예시

CReBar::AddBar에 대한 예제를 참조하세요.

CReBar::GetReBarCtrl

이 멤버 함수를 사용하면 기본 공용 컨트롤에 직접 액세스할 수 있습니다.

CReBarCtrl& GetReBarCtrl() const;

Return Value

CReBarCtrl 개체에 대한 참조입니다.

설명

이 멤버 함수를 호출하여 리바를 사용자 지정할 때 Windows Rebar 일반 컨트롤의 기능을 활용합니다. 호출 GetReBarCtrl할 때 두 멤버 함수 집합 중 하나를 사용할 수 있도록 개체에 CReBarCtrl 대한 참조 개체를 반환합니다.

Rebar를 사용자 지정하는 데 사용하는 CReBarCtrl 방법에 대한 자세한 내용은 CReBarCtrl 사용을 참조하세요.

예시

CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();

UINT nBandCount = refReBarCtrl.GetBandCount();
CString msg;
msg.Format(_T("Band Count is: %u"), nBandCount);
AfxMessageBox(msg);

참고 항목

MFC 샘플 MFCIE
CControlBar Class
계층 구조 차트