CReBarCtrl 클래스

자식 창의 컨테이너인 rebar 컨트롤의 기능을 캡슐화합니다.

구문

class CReBarCtrl : public CWnd

멤버

공용 생성자

속성	설명
CReBarCtrl::CReBarCtrl	CReBarCtrl 개체를 생성합니다.

공용 메서드

이름	설명
CReBarCtrl::BeginDrag	rebar 컨트롤을 끌어서 놓기 모드로 전환합니다.
CReBarCtrl::Create	Rebar 컨트롤을 만들어 개체에 CReBarCtrl 연결합니다.
CReBarCtrl::CreateEx	지정된 Windows 확장 스타일을 사용하여 rebar 컨트롤을 만들고 개체에 CReBarCtrl 연결합니다.
CReBarCtrl::D eleteBand	rebar 컨트롤에서 밴드를 삭제합니다.
CReBarCtrl::D ragMove	를 호출한 후 rebar 컨트롤의 끌기 위치를 업데이트합니다 BeginDrag.
CReBarCtrl::EndDrag	rebar 컨트롤의 끌어서 놓기 작업을 종료합니다.
CReBarCtrl::GetBandBorders	밴드의 테두리를 검색합니다.
CReBarCtrl::GetBandCount	현재 rebar 컨트롤에 있는 밴드 수를 검색합니다.
CReBarCtrl::GetBandInfo	rebar 컨트롤에서 지정된 밴드에 대한 정보를 검색합니다.
CReBarCtrl::GetBandMargins	밴드의 여백을 검색합니다.
CReBarCtrl::GetBarHeight	rebar 컨트롤의 높이를 검색합니다.
CReBarCtrl::GetBarInfo	rebar 컨트롤과 사용하는 이미지 목록에 대한 정보를 검색합니다.
CReBarCtrl::GetBkColor	rebar 컨트롤의 기본 배경색을 검색합니다.
CReBarCtrl::GetColorScheme	철근 컨트롤과 연결된 COLORSCHEME 구조를 검색합니다.
CReBarCtrl::GetDropTarget	rebar 컨트롤의 IDropTarget 인터페이스 포인터를 검색합니다.
CReBarCtrl::GetExtendedStyle	현재 rebar 컨트롤의 확장 스타일을 가져옵니다.
CReBarCtrl::GetImageList	rebar 컨트롤과 연결된 이미지 목록을 검색합니다.
CReBarCtrl::GetPalette	rebar 컨트롤의 현재 팔레트를 검색합니다.
CReBarCtrl::GetRect	rebar 컨트롤에서 지정된 밴드의 경계 사각형을 검색합니다.
CReBarCtrl::GetRowCount	rebar 컨트롤의 밴드 행 수를 검색합니다.
CReBarCtrl::GetRowHeight	rebar 컨트롤에서 지정된 행의 높이를 검색합니다.
CReBarCtrl::GetTextColor	rebar 컨트롤의 기본 텍스트 색을 검색합니다.
CReBarCtrl::GetToolTips	rebar 컨트롤과 연결된 도구 설명 컨트롤에 대한 핸들을 검색합니다.
CReBarCtrl::HitTest	rebar 밴드가 해당 지점에 있는 경우 화면의 지정된 지점에 있는 rebar 밴드 부분을 결정합니다.
CReBarCtrl::IDToIndex	대역 식별자(ID)를 rebar 컨트롤의 대역 인덱스로 변환합니다.
CReBarCtrl::InsertBand	rebar 컨트롤에 새 밴드를 삽입합니다.
CReBarCtrl::MaximizeBand	rebar 컨트롤의 밴드 크기를 가장 큰 크기로 조정합니다.
CReBarCtrl::MinimizeBand	rebar 컨트롤의 밴드 크기를 가장 작은 크기로 조정합니다.
CReBarCtrl::MoveBand	한 인덱스에서 다른 인덱스로 밴드를 이동합니다.
CReBarCtrl::P ushChevron	프로그래밍 방식으로 펼침 단추를 푸시합니다.
CReBarCtrl::RestoreBand	리바 컨트롤의 밴드 크기를 이상적인 크기로 조정합니다.
CReBarCtrl::SetBandInfo	rebar 컨트롤에서 기존 밴드의 특성을 설정합니다.
CReBarCtrl::SetBandWidth	현재 철근 컨트롤에서 지정한 도킹된 대역의 너비를 설정합니다.
CReBarCtrl::SetBarInfo	rebar 컨트롤의 특성을 설정합니다.
CReBarCtrl::SetBkColor	rebar 컨트롤의 기본 배경색을 설정합니다.
CReBarCtrl::SetColorScheme	Rebar 컨트롤의 단추에 대한 색 구성표를 설정합니다.
CReBarCtrl::SetExtendedStyle	현재 철근 컨트롤의 확장 스타일을 설정합니다.
CReBarCtrl::SetImageList	Rebar 컨트롤의 이미지 목록을 설정합니다.
CReBarCtrl::SetOwner	Rebar 컨트롤의 소유자 창을 설정합니다.
CReBarCtrl::SetPalette	rebar 컨트롤의 현재 팔레트를 설정합니다.
CReBarCtrl::SetTextColor	rebar 컨트롤의 기본 텍스트 색을 설정합니다.
CReBarCtrl::SetToolTips	도구 설명 컨트롤을 철근 컨트롤과 연결합니다.
CReBarCtrl::SetWindowTheme	Rebar 컨트롤의 비주얼 스타일을 설정합니다.
CReBarCtrl::ShowBand	rebar 컨트롤에서 지정된 밴드를 표시하거나 숨깁니다.
CReBarCtrl::SizeToRect	Rebar 컨트롤을 지정된 사각형에 맞습니다.

설명

rebar 컨트롤이 상주하는 애플리케이션은 rebar 컨트롤에 포함된 자식 창을 rebar 밴드에 할당합니다. 자식 창은 일반적으로 다른 일반적인 컨트롤입니다.

Rebar 컨트롤에는 하나 이상의 밴드가 포함됩니다. 각 밴드에는 그리퍼 막대, 비트맵, 텍스트 레이블 및 자식 창의 조합이 포함될 수 있습니다. 밴드는 이러한 각 항목 중 하나만 포함할 수 있습니다.

Rebar 컨트롤은 지정된 배경 비트맵 위에 자식 창을 표시할 수 있습니다. RBBS_FIXEDSIZE 스타일을 사용하는 것을 제외하고 모든 rebar 컨트롤 밴드의 크기를 조정할 수 있습니다. Rebar 컨트롤 대역의 위치를 변경하거나 크기를 조정하면 rebar 컨트롤이 해당 밴드에 할당된 자식 창의 크기와 위치를 관리합니다. 컨트롤 내에서 밴드의 크기를 조정하거나 순서를 변경하려면 밴드의 위치 조정 막대 막대를 클릭하고 끕니다.

다음 그림에서는 세 개의 밴드가 있는 철근 컨트롤을 보여 줍니다.

• 밴드 0에는 평평하고 투명한 도구 모음 컨트롤이 포함되어 있습니다.

• 밴드 1에는 투명한 표준 및 투명한 드롭다운 단추가 모두 포함되어 있습니다.

• 밴드 2에는 콤보 상자와 4개의 표준 단추가 포함되어 있습니다.

  

Rebar 컨트롤

Rebar 컨트롤 지원:

• 이미지 목록입니다.

• 메시지 처리.

• 사용자 지정 그리기 기능

• 표준 창 스타일 외에도 다양한 컨트롤 스타일이 있습니다. 이러한 스타일 목록은 Windows SDK의 Rebar 컨트롤 스타일을 참조하세요.

자세한 내용은 CReBarCtrl 사용을 참조 하세요.

상속 계층 구조

CObject

CCmdTarget

CWnd

CReBarCtrl

요구 사항

헤더: afxcmn.h

CReBarCtrl::BeginDrag

Windows SDK에 설명된 대로 Win32 메시지 RB_BEGINDRAG 동작을 구현합니다.

void BeginDrag(
    UINT uBand,
    DWORD dwPos = (DWORD)-1);

매개 변수

uBand
끌어서 놓기 작업에 영향을 줄 밴드의 인덱스(0부터 시작)입니다.

dwPos
시작 마우스 좌표를 포함하는 DWORD 값입니다. 가로 좌표는 LOWORD에 포함되고 세로 좌표는 HIWORD에 포함됩니다. (DWORD)-1을 전달하면 rebar 컨트롤은 컨트롤의 스레드가 마지막으로 호출 GetMessage 되거나 PeekMessage호출될 때 마우스 위치를 사용합니다.

CReBarCtrl::Create

Rebar 컨트롤을 만들어 개체에 CReBarCtrl 연결합니다.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

매개 변수

dwStyle
컨트롤에 적용된 철근 컨트롤 스타일의 조합을 지정합니다. 지원되는 스타일 목록은 Windows SDK의 Rebar 컨트롤 스타일을 참조하세요.

rect
Rebar 컨트롤의 위치 및 크기인 CRect 개체 또는 RECT 구조체에 대한 참조입니다.

pParentWnd
Rebar 컨트롤의 부모 창인 CWnd 개체에 대한 포인터입니다. NULL이 아니어야 합니다.

nID
rebar 컨트롤의 컨트롤 ID를 지정합니다.

Return Value

개체가 성공적으로 만들어진 경우 0이 아닌 경우 그렇지 않으면 0입니다.

설명

다음 두 단계로 rebar 컨트롤을 만듭니다.

1. CReBarCtrl을 호출하여 개체를 생성합니다CReBarCtrl.

2. Windows Rebar 컨트롤을 만들고 개체에 연결하는 이 멤버 함수를 CReBarCtrl 호출합니다.

호출 Create할 때 공통 컨트롤이 초기화됩니다.

예시

CReBarCtrl *pReBarCtrl = new CReBarCtrl();
CRect rect;
GetWindowRect(rect);
pReBarCtrl->Create(RBS_BANDBORDERS, rect, this, AFX_IDW_REBAR);

// Use ReBar Control.

delete pReBarCtrl;

CReBarCtrl::CreateEx

컨트롤(자식 창)을 만들어 개체와 연결 CReBarCtrl 합니다.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

매개 변수

dwExStyle
만들 컨트롤의 확장 스타일을 지정합니다. 확장된 Windows 스타일 목록은 Windows SDK의 CreateWindowEx에 대한 dwExStyle 매개 변수를 참조하세요.

dwStyle
컨트롤에 적용된 철근 컨트롤 스타일의 조합을 지정합니다. 지원되는 스타일 목록은 Windows SDK의 Rebar 컨트롤 스타일을 참조하세요.

rect
pParentWnd의 클라이언트 좌표에서 만들 창의 크기와 위치를 설명하는 RECT 구조체에 대한 참조입니다.

pParentWnd
컨트롤의 부모 창에 대한 포인터입니다.

nID
컨트롤의 자식 창 ID입니다.

Return Value

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

설명

Windows 확장 스타일 서문 WS_EX_ 지정된 확장 Windows 스타일을 적용하려면 만들기 대신 사용합니다CreateEx.

CReBarCtrl::CReBarCtrl

CReBarCtrl 개체를 만듭니다.

CReBarCtrl();

예시

CReBarCtrl::Create에 대한 예제를 참조하세요.

CReBarCtrl::D eleteBand

Windows SDK에 설명된 대로 Win32 메시지 RB_DELETEBAND 동작을 구현합니다.

BOOL DeleteBand(UINT uBand);

매개 변수

uBand
삭제할 밴드의 인덱스(0부터 시작)입니다.

Return Value

밴드가 성공적으로 삭제된 경우 0이 아닌 경우 그렇지 않으면 0입니다.

예시

UINT nCount = m_wndReBar.GetReBarCtrl().GetBandCount();

if (nCount > 0)
   m_wndReBar.GetReBarCtrl().DeleteBand(nCount - 1);

CReBarCtrl::D ragMove

Windows SDK에 설명된 대로 Win32 메시지 RB_DRAGMOVE 동작을 구현합니다.

void DragMove(DWORD dwPos = (DWORD)-1);

매개 변수

dwPos
새 마우스 좌표를 포함하는 DWORD 값입니다. 가로 좌표는 LOWORD에 포함되고 세로 좌표는 HIWORD에 포함됩니다. (DWORD)-1을 전달하면 rebar 컨트롤은 컨트롤의 스레드가 마지막으로 호출 GetMessage 되거나 PeekMessage호출될 때 마우스 위치를 사용합니다.

CReBarCtrl::EndDrag

Windows SDK에 설명된 대로 Win32 메시지 RB_ENDDRAG 동작을 구현합니다.

void EndDrag();

CReBarCtrl::GetBandBorders

Windows SDK에 설명된 대로 Win32 메시지 RB_GETBANDBORDERS 동작을 구현합니다.

void GetBandBorders(
    UINT uBand,
    LPRECT prc) const;

매개 변수

uBand
경계를 검색할 밴드의 인덱스(0부터 시작)입니다.

prc
대역 테두리를 받을 RECT 구조체에 대한 포인터입니다. rebar 컨트롤에 RBS_BANDBORDERS 스타일이 있는 경우 이 구조체의 각 멤버는 테두리를 구성하는 밴드의 해당 측면에서 픽셀 수를 받습니다. rebar 컨트롤에 RBS_BANDBORDERS 스타일이 없으면 이 구조체의 left 멤버만 유효한 정보를 받습니다. 철근 컨트롤 스타일에 대한 설명은 Windows SDK의 Rebar 컨트롤 스타일을 참조하세요.

CReBarCtrl::GetBandCount

Windows SDK에 설명된 대로 Win32 메시지 RB_GETBANDCOUNT 동작을 구현합니다.

UINT GetBandCount() const;

Return Value

컨트롤에 할당된 밴드 수입니다.

CReBarCtrl::GetBandInfo

Windows SDK에 설명된 대로 Win32 메시지 RB_GETBANDINFO 동작을 구현합니다.

BOOL GetBandInfo(
    UINT uBand,
    REBARBANDINFO* prbbi) const;

매개 변수

uBand
정보가 검색될 대역의 인덱스(0부터 시작)입니다.

prbbi
밴드 정보를 받을 REBARBANDINFO 구조체에 대한 포인터입니다. 이 메시지를 보내기 전에 이 구조체의 멤버를 sizeof(REBARBANDINFO) 설정하고 검색할 항목으로 멤버를 설정 cbSize fMask 해야 합니다.

Return Value

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

CReBarCtrl::GetBandMargins

대역의 여백을 검색합니다.

void GetBandMargins(PMARGINS pMargins);

매개 변수

pMargins
정보를 받을 MARGINS구조체에 대한 포인터입니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 RB_GETBANDMARGINS 메시지의 기능을 에뮬레이트합니다.

CReBarCtrl::GetBarHeight

철근 막대의 높이를 검색합니다.

UINT GetBarHeight() const;

Return Value

컨트롤의 높이(픽셀)를 나타내는 값입니다.

CReBarCtrl::GetBarInfo

Windows SDK에 설명된 대로 Win32 메시지 RB_GETBARINFO 동작을 구현합니다.

BOOL GetBarInfo(REBARINFO* prbi) const;

매개 변수

prbi
rebar 컨트롤 정보를 받을 REBARINFO 구조체에 대한 포인터입니다. 이 메시지를 보내기 전에 이 구조체의 cbSize 멤버를 sizeof(REBARINFO) 설정해야 합니다.

Return Value

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

CReBarCtrl::GetBkColor

Windows SDK에 설명된 대로 Win32 메시지 RB_GETBKCOLOR 동작을 구현합니다.

COLORREF GetBkColor() const;

Return Value

현재 기본 배경색을 나타내는 COLORREF 값입니다.

CReBarCtrl::GetColorScheme

철근 컨트롤에 대한 COLORSCHEME 구조를 검색합니다.

BOOL GetColorScheme(COLORSCHEME* lpcs);

매개 변수

lpcs
Windows SDK에 설명된 대로 COLORSCHEME 구조체에 대한 포인터입니다.

Return Value

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

설명

구조체에는 COLORSCHEME 단추 강조 색과 단추 그림자 색이 포함됩니다.

CReBarCtrl::GetDropTarget

Windows SDK에 설명된 대로 Win32 메시지 RB_GETDROPTARGET 동작을 구현합니다.

IDropTarget* GetDropTarget() const;

Return Value

IDropTarget 인터페이스에 대한 포인터 입니다 .

CReBarCtrl::GetExtendedStyle

현재 rebar 컨트롤의 확장된 스타일을 가져옵니다.

DWORD GetExtendedStyle() const;

Return Value

확장 스타일을 나타내는 플래그의 비트 조합(OR)입니다. 가능한 플래그는 RBS_EX_SPLITTER RBS_EX_TRANSPARENT. 자세한 내용은 CReBarCtrl::SetExtendedStyle 메서드의 dwMask 매개 변수를 참조하세요.

설명

이 메서드는 Windows SDK에 설명된 RB_GETEXTENDEDSTYLE 메시지를 보냅니다.

CReBarCtrl::GetImageList

CImageList rebar 컨트롤과 연결된 개체를 가져옵니다.

CImageList* GetImageList() const;

Return Value

CImageList 개체에 대한 포인터입니다 . 컨트롤에 대해 설정된 이미지 목록이 없으면 NULL을 반환합니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 REBARINFO 구조에 저장된 크기 및 마스크 정보를 사용합니다.

CReBarCtrl::GetPalette

rebar 컨트롤의 현재 팔레트를 검색합니다.

CPalette* GetPalette() const;

Return Value

Rebar 컨트롤의 현재 색상표를 지정하는 CPalette 개체에 대한 포인터입니다.

설명

이 멤버 함수는 HPALETTE가 아닌 반환 값으로 개체를 사용합니다 CPalette .

예시

CPalette *pPalette = m_wndReBar.GetReBarCtrl().GetPalette();
if (pPalette)
{
   int nEntries = pPalette->GetEntryCount();
   CString msg;
   msg.Format(_T("Number of palette entries: %d"), nEntries);
   AfxMessageBox(msg);
}
else
{
   AfxMessageBox(_T("No palette!"));
}

CReBarCtrl::GetRect

Windows SDK에 설명된 대로 Win32 메시지 RB_GETRECT 동작을 구현합니다.

BOOL GetRect(
    UINT uBand,
    LPRECT prc) const;

매개 변수

uBand
rebar 컨트롤에 있는 밴드의 0부터 시작하는 인덱스입니다.

prc
REBAR 대역의 경계를 수신할 RECT 구조체에 대한 포인터입니다.

Return Value

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

예시

CRect rc;
m_wndReBar.GetReBarCtrl().GetRect(0, &rc);
CString msg;
msg.Format(_T("rect.left = %d, rect.top = %d, ")
           _T("rect.right = %d, rect.bottom = %d"),
           rc.left,
           rc.top, rc.right, rc.bottom);
AfxMessageBox(msg);

CReBarCtrl::GetRowCount

Windows SDK에 설명된 대로 Win32 메시지 RB_GETROWCOUNT 동작을 구현합니다.

UINT GetRowCount() const;

Return Value

컨트롤의 밴드 행 수를 나타내는 UINT 값입니다.

예시

UINT nRowCount = m_wndReBar.GetReBarCtrl().GetRowCount();
CString msg;
msg.Format(_T("Row Count is %d"), nRowCount);
AfxMessageBox(msg);

CReBarCtrl::GetRowHeight

Windows SDK에 설명된 대로 Win32 메시지 RB_GETROWHEIGHT 동작을 구현합니다.

UINT GetRowHeight(UINT uRow) const;

매개 변수

uRow
높이를 검색할 대역의 인덱스(0부터 시작하는 인덱스)입니다.

Return Value

행 높이를 픽셀 단위로 나타내는 UINT 값입니다.

예시

int nCount = m_wndReBar.GetReBarCtrl().GetRowCount();
for (int i = 0; i < nCount; i++)
{
   UINT nHeight = m_wndReBar.GetReBarCtrl().GetRowHeight(i);
   CString msg;
   msg.Format(_T("Height of row %d is %u"), i, nHeight);
   AfxMessageBox(msg);
}

CReBarCtrl::GetTextColor

Windows SDK에 설명된 대로 Win32 메시지 RB_GETTEXTCOLOR 동작을 구현합니다.

COLORREF GetTextColor() const;

Return Value

현재 기본 텍스트 색을 나타내는 COLORREF 값입니다.

CReBarCtrl::GetToolTips

Windows SDK에 설명된 대로 Win32 메시지 RB_GETTOOLTIPS 동작을 구현합니다.

CToolTipCtrl* GetToolTips() const;

Return Value

CToolTipCtrl 개체에 대한 포인터입니다.

설명

MFC 구현은 GetToolTips HWND가 아닌 포인터 CToolTipCtrl를 반환합니다.

CReBarCtrl::HitTest

Windows SDK에 설명된 대로 Win32 메시지 RB_HITTEST 동작을 구현합니다.

int HitTest(RBHITTESTINFO* prbht);

매개 변수

prbht
RBHITTESTINFO 구조체에 대한 포인터입니다. 메시지를 pt 보내기 전에 이 구조체의 멤버를 클라이언트 좌표로 테스트할 지점으로 초기화해야 합니다.

Return Value

지정된 지점에 있는 대역의 인덱스(0부터 시작하는 인덱스)이거나, 해당 지점에 rebar 밴드가 없으면 -1입니다.

CReBarCtrl::IDToIndex

Windows SDK에 설명된 대로 Win32 메시지 RB_IDTOINDEX 동작을 구현합니다.

int IDToIndex(UINT uBandID) const;

매개 변수

uBandID
지정된 대역의 애플리케이션 정의 식별자이며, 밴드가 삽입될 wID 때 REBARBANDINFO 구조체의 멤버에 전달됩니다.

Return Value

성공하면 0부터 시작하는 대역 인덱스이거나, 그렇지 않으면 -1입니다. 중복 대역 인덱스가 있는 경우 첫 번째 인덱스가 반환됩니다.

CReBarCtrl::InsertBand

Windows SDK에 설명된 대로 Win32 메시지 RB_INSERTBAND 동작을 구현합니다.

BOOL InsertBand(
    UINT uIndex,
    REBARBANDINFO* prbbi);

매개 변수

uIndex
밴드가 삽입될 위치의 인덱스(0부터 시작)입니다. 이 매개 변수를 -1로 설정하면 컨트롤이 마지막 위치에 새 밴드를 추가합니다.

prbbi
삽입할 밴드를 정의하는 REBARBANDINFO 구조체에 대한 포인터입니다. 이 함수를 호출하기 전에 이 구조체의 cbSize 멤버를 sizeof(REBARBANDINFO) 설정해야 합니다.

Return Value

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

예시

REBARBANDINFO rbbi = {0};
rbbi.cbSize = sizeof(rbbi);

TCHAR szText[80];
rbbi.lpText = szText;
rbbi.cch = sizeof(szText) / sizeof(szText[0]);

rbbi.fMask = RBBIM_BACKGROUND | RBBIM_CHILD |
             RBBIM_CHILDSIZE | RBBIM_COLORS | RBBIM_HEADERSIZE |
             RBBIM_IDEALSIZE | RBBIM_ID | RBBIM_IMAGE |
             RBBIM_LPARAM | RBBIM_SIZE | RBBIM_STYLE | RBBIM_TEXT;

m_wndReBar.GetReBarCtrl().GetBandInfo(0, &rbbi);

m_wndReBar.GetReBarCtrl().InsertBand(1, &rbbi);

CReBarCtrl::MaximizeBand

rebar 컨트롤의 밴드 크기를 가장 큰 크기로 조정합니다.

void MaximizeBand(UINT uBand);

매개 변수

uBand
최대화할 대역의 인덱스(0부터 시작)입니다.

설명

Windows SDK에 설명된 대로 Win32 메시지 RB_MAXIMIZEBAND 동작을 0으로 fIdeal 설정하여 구현합니다.

예시

CReBarCtrl& refReBarCtrl = m_wndReBar.GetReBarCtrl();
UINT nCount = refReBarCtrl.GetBandCount();

for (UINT i = 0; i < nCount; i++)
   refReBarCtrl.MaximizeBand(i);   

CReBarCtrl::MinimizeBand

rebar 컨트롤의 밴드 크기를 가장 작은 크기로 조정합니다.

void MinimizeBand(UINT uBand);

매개 변수

uBand
최소화할 대역의 인덱스(0부터 시작)입니다.

설명

Windows SDK에 설명된 대로 Win32 메시지 RB_MINIMIZEBAND 동작을 구현합니다.

예시

CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();
UINT nCount = refReBarCtrl.GetBandCount();

for (UINT i = 0; i < nCount; i++)
   refReBarCtrl.MinimizeBand(i);

CReBarCtrl::MoveBand

Windows SDK에 설명된 대로 Win32 메시지 RB_MOVEBAND 동작을 구현합니다.

BOOL MoveBand(
    UINT uFrom,
    UINT uTo);

매개 변수

uFrom
이동할 밴드의 인덱스(0부터 시작)입니다.

uTo
새 밴드 위치의 인덱스(0부터 시작)입니다. 이 매개 변수 값은 밴드 수에서 1을 뺀 값보다 커서는 안 됩니다. 밴드 수를 가져오려면 GetBandCount를 호출 합니다.

Return Value

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

CReBarCtrl::P ushChevron

Windows SDK에 설명된 대로 Win32 메시지 RB_PUSHCHEVRON 동작을 구현합니다.

void PushChevron(
    UINT uBand,
    LPARAM lAppValue);

매개 변수

uBand
갈매기형이 눌러질 밴드의 인덱스(0부터 시작)입니다.

lAppValue
애플리케이션에서 32비트 값을 정의했습니다. Windows SDK의 RB_PUSHCHEVRON lAppValue를 참조하세요.

CReBarCtrl::RestoreBand

리바 컨트롤의 밴드 크기를 이상적인 크기로 조정합니다.

void RestoreBand(UINT uBand);

매개 변수

uBand
최대화할 대역의 인덱스(0부터 시작)입니다.

설명

Windows SDK에 설명된 대로 Win32 메시지 RB_MAXIMIZEBAND fIdeal 동작을 1로 설정하여 구현합니다.

예시

CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();
UINT nCount = refReBarCtrl.GetBandCount();

for (UINT i = 0; i < nCount; i++)
   refReBarCtrl.RestoreBand(i);

CReBarCtrl::SetBandInfo

Windows SDK에 설명된 대로 Win32 메시지 RB_SETBANDINFO 동작을 구현합니다.

BOOL SetBandInfo(
    UINT uBand,
    REBARBANDINFO* prbbi);

매개 변수

uBand
새로운 설정을 받을 밴드의 인덱스(0부터 시작)입니다.

prbbi
삽입할 밴드를 정의하는 RebarBANDINFO 구조체에 대한 포인터입니다. 이 메시지를 보내기 전에 이 구조체의 멤버를 sizeof(REBARBANDINFO) 설정 cbSize 해야 합니다.

Return Value

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

예시

int nCount = m_wndReBar.GetReBarCtrl().GetBandCount();
CString strText;
REBARBANDINFO rbbi = {0};
rbbi.cbSize = sizeof(rbbi);
for (int i = 0; i < nCount; i++)
{
   strText.Format(_T("Band #: %d"), i);
   rbbi.lpText = strText.GetBuffer();
   rbbi.cch = strText.GetLength() + 1;
   rbbi.fMask = RBBIM_TEXT;

   m_wndReBar.GetReBarCtrl().SetBandInfo(i, &rbbi);

   strText.ReleaseBuffer();
}

CReBarCtrl::SetBandWidth

현재 철근 컨트롤에서 지정한 도킹된 대역의 너비를 설정합니다.

BOOL SetBandWidth(
    UINT uBand,
    int cxWidth);

매개 변수

uBand
[in] Rebar 대역의 인덱스(0부터 시작하는 인덱스)입니다.

cxWidth
[in] 철근 대역의 새 너비(픽셀)입니다.

Return Value

메서드가 성공하면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

이 메서드는 Windows SDK에 설명된 RB_SETBANDWIDTH 메시지를 보냅니다.

예시

첫 번째 코드 예제는 현재 rebar 컨트롤에 액세스하는 데 사용되는 변수 m_rebar를 정의합니다. 이 변수는 다음 예제에서 사용됩니다.

public:
CReBarCtrl m_rebar;
BOOL bRet;
static const int TOTAL_BANDS = 5;
static const int BUFFER_SIZE = 10;

다음 코드 예제에서는 각 rebar 밴드를 동일한 너비로 설정합니다.

// Set the width of each band.
m_rebar.GetClientRect(&rect);
int iWidth = rect.Width() / TOTAL_BANDS;
for (int iIndex = 0; iIndex < TOTAL_BANDS; iIndex++)
   bRet = m_rebar.SetBandWidth(iIndex, iWidth);

CReBarCtrl::SetBarInfo

Windows SDK에 설명된 대로 Win32 메시지 RB_SETBARINFO 동작을 구현합니다.

BOOL SetBarInfo(REBARINFO* prbi);

매개 변수

prbi
설정할 정보가 들어 있는 REBARINFO 구조체에 대한 포인터입니다. 이 메시지를 보내기 전에 이 구조체의 멤버를 sizeof(REBARINFO) 설정 cbSize 해야 합니다.

Return Value

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

예시

REBARINFO rbi = {0};
rbi.cbSize = sizeof(REBARINFO);
rbi.fMask = 0;
rbi.himl = 0;
m_wndReBar.GetReBarCtrl().SetBarInfo(&rbi);

CReBarCtrl::SetBkColor

Windows SDK에 설명된 대로 Win32 메시지 RB_SETBKCOLOR 동작을 구현합니다.

COLORREF SetBkColor(COLORREF clr);

매개 변수

clr
새 기본 배경색을 나타내는 COLORREF 값입니다.

Return Value

이전의 기본 배경색을 나타내는 COLORREF 값입니다.

설명

배경색을 설정하는 시기 및 기본값을 설정하는 방법에 대한 자세한 내용은 이 항목을 참조하세요.

CReBarCtrl::SetColorScheme

Rebar 컨트롤의 단추에 대한 색 구성표를 설정합니다.

void SetColorScheme(const COLORSCHEME* lpcs);

매개 변수

lpcs
Windows SDK에 설명된 대로 COLORSCHEME 구조체에 대한 포인터입니다.

설명

구조체에는 COLORSCHEME 단추 강조 색과 단추 그림자 색이 모두 포함됩니다.

CReBarCtrl::SetExtendedStyle

현재 철근 컨트롤의 확장 스타일을 설정합니다.

DWORD SetExtendedStyle(
    DWORD dwMask,
    DWORD dwStyleEx);

매개 변수

dwMask
[in] dwStyleEx 매개 변수에서 적용되는 플래그를 지정하는 플래그 의 비트 조합(OR)입니다 . 다음 값 중 하나 이상을 사용합니다.

• RBS_EX_SPLITTER: 기본적으로 가로 모드에서 아래쪽에 분할자를 표시하고 오른쪽에 세로 모드로 표시합니다.
• RBS_EX_TRANSPARENT: WM_ERASEBKGND 메시지를 부모 창으로 전달합니다.

dwStyleEx
[in] 적용할 스타일을 지정하는 플래그의 비트 조합(OR)입니다. 스타일을 설정하려면 dwMask 매개 변수에 사용되는 것과 동일한 플래그를 지정합니다. 스타일을 다시 설정하려면 이진 0을 지정합니다.

Return Value

이전 확장 스타일입니다.

설명

이 메서드는 Windows SDK에 설명된 RB_SETEXTENDEDSTYLE 메시지를 보냅니다.

CReBarCtrl::SetImageList

이미지 목록을 rebar 컨트롤에 할당합니다.

BOOL SetImageList(CImageList* pImageList);

매개 변수

pImageList
Rebar 컨트롤에 할당할 이미지 목록을 포함하는 CImageList 개체에 대한 포인터입니다.

Return Value

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

CReBarCtrl::SetOwner

Windows SDK에 설명된 대로 Win32 메시지 RB_SETPARENT 동작을 구현합니다.

CWnd* SetOwner(CWnd* pWnd);

매개 변수

pWnd
철근 컨트롤의 CWnd 소유자로 설정할 개체에 대한 포인터입니다.

Return Value

Rebar 컨트롤의 현재 소유자인 CWnd 개체에 대한 포인터입니다.

설명

이 멤버 함수는 창에 CWnd 대한 핸들이 아니라 Rebar 컨트롤의 현재 소유자와 선택한 소유자 모두에 대한 개체에 대한 포인터를 사용합니다.

참고 항목

이 멤버 함수는 컨트롤을 만들 때 설정된 실제 부모를 변경하지 않습니다. 대신 지정한 창에 알림 메시지를 보냅니다.

CReBarCtrl::SetPalette

Windows SDK에 설명된 대로 Win32 메시지 RB_SETPALETTE 동작을 구현합니다.

CPalette* SetPalette(HPALETTE hPal);

매개 변수

hPal
rebar 컨트롤이 사용할 새 팔레트를 지정하는 HPALETTE입니다.

Return Value

Rebar 컨트롤의 이전 색상표를 지정하는 CPalette 개체에 대한 포인터입니다.

설명

이 멤버 함수는 HPALETTE가 아닌 반환 값으로 개체를 사용합니다 CPalette .

CReBarCtrl::SetTextColor

Windows SDK에 설명된 대로 Win32 메시지 RB_SETTEXTCOLOR 동작을 구현합니다.

COLORREF SetTextColor(COLORREF clr);

매개 변수

clr
개체의 새 텍스트 색 CReBarCtrl 을 나타내는 COLORREF 값입니다.

Return Value

개체와 CReBarCtrl 연결된 이전 텍스트 색을 나타내는 COLORREF 값입니다.

설명

이 기능은 철근 컨트롤에서 텍스트 색 유연성을 지원하기 위해 제공됩니다.

CReBarCtrl::SetToolTips

도구 설명 컨트롤을 rebar 컨트롤과 연결합니다.

void SetToolTips(CToolTipCtrl* pToolTip);

매개 변수

pToolTip
CToolTipCtrl 개체에 대한 포인터

설명

작업을 완료하면 개체를 CToolTipCtrl 삭제해야 합니다.

CReBarCtrl::SetWindowTheme

Rebar 컨트롤의 비주얼 스타일을 설정합니다.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

매개 변수

pszSubAppName
설정할 철근 비주얼 스타일을 포함하는 유니코드 문자열에 대한 포인터입니다.

Return Value

반환 값은 사용되지 않습니다.

설명

이 멤버 함수는 Windows SDK에 설명된 대로 RB_SETWINDOWTHEME 메시지의 기능을 에뮬레이트합니다.

CReBarCtrl::ShowBand

Windows SDK에 설명된 대로 Win32 메시지 RB_SHOWBAND 동작을 구현합니다.

BOOL ShowBand(
    UINT uBand,
    BOOL fShow = TRUE);

매개 변수

uBand
rebar 컨트롤에 있는 밴드의 0부터 시작하는 인덱스입니다.

fShow
밴드를 표시하거나 숨길지 여부를 나타냅니다. 이 값이 TRUE이면 밴드가 표시됩니다. 그렇지 않으면 밴드가 숨겨집니다.

Return Value

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

CReBarCtrl::SizeToRect

Windows SDK에 설명된 대로 Win32 메시지 RB_SIZETORECT 동작을 구현합니다.

BOOL SizeToRect(CRect& rect);

매개 변수

rect
rebar 컨트롤의 크기를 조정해야 하는 사각형을 지정하는 CRect 개체에 대한 참조입니다.

Return Value

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

설명

이 멤버 함수는 개체를 CRect 구조체가 아닌 매개 변수로 RECT 사용합니다.

참고 항목

CWnd 클래스
계층 구조 차트