Класс CReBar

Панель элементов управления, которая предоставляет макет, сохраняемость и сведения о состоянии для элементов управления главной панели.

Синтаксис

class CReBar : public CControlBar

Участники

Открытые методы

Имя	Описание
CReBar::AddBar	Добавляет полосу на перекладку.
CReBar::Create	Создает элемент управления rebar и присоединяет его к объекту CReBar .
CReBar::GetReBarCtrl	Разрешает прямой доступ к базовому общему элементу управления.

Замечания

Объект перебара может содержать различные дочерние окна, как правило, другие элементы управления, включая поля редактирования, панели инструментов и списки. Объект перебора может отображать дочерние окна по указанному растровом рисунку. Ваше приложение может автоматически изменить размер панели, или пользователь может вручную изменить размер панели, щелкнув или перетащив панель захвата.

Элемент управления "Перерезка"

Объект rebar работает аналогично объекту панели инструментов. На панели используется механизм щелчка и перетаскивания для изменения размера полос. Элемент управления rebar может содержать одну или несколько полос, причем каждая группа имеет любое сочетание панели захвата, растрового изображения, текстовой метки и дочернего окна. Однако полосы не могут содержать несколько дочерних окон.

CReBarиспользует класс CReBarCtrl для предоставления его реализации. Вы можете получить доступ к элементу управления перебары через GetReBarCtrl , чтобы воспользоваться параметрами настройки элемента управления. Дополнительные сведения об элементах управления перекладиной см. в разделе CReBarCtrl. Дополнительные сведения об использовании элементов управления перебары см. в разделе "Использование CReBarCtrl".

Внимание

Объекты элемента управления "Перебара" и "Перебарыш" не поддерживают закрепление панели управления 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, представляющее цвет фона панели.

Возвращаемое значение

Имеет ненулевое значение в случае успешного выполнения, иначе — 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

Вызовите эту функцию-член, чтобы создать перекладку.

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
Указатель на CWnd объект, окно Windows которого является родительским элементом строки состояния. Обычно окно фрейма.

dwCtrlStyle
Стиль элемента управления rebar. По умолчанию RBS_BANDBORDERS, где отображаются узкие линии для разделения смежных полос в элементе управления rebar. Список стилей элементов управления см . в статье "Стили элементов управления "Перебар" в пакете SDK для Windows.

dwStyle
Стили окна перерезки.

nID
Идентификатор дочернего окна панели.

Возвращаемое значение

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.

Пример

См. пример CReBar::AddBar.

CReBar::GetReBarCtrl

Эта функция-член позволяет напрямую обращаться к базовому общему элементу управления.

CReBarCtrl& GetReBarCtrl() const;

Возвращаемое значение

Ссылка на объект CReBarCtrl .

Замечания

Вызовите эту функцию-член, чтобы воспользоваться функциональностью общей панели Windows при настройке панели перестроения. При вызове GetReBarCtrlон возвращает объект ссылки для CReBarCtrl объекта, чтобы использовать любой набор функций-членов.

Дополнительные сведения об использовании 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
Диаграмма иерархии