Класс CMFCReBar

  • Статья

CMFCReBar Объект — это панель управления, которая предоставляет сведения о макете, сохраняемости и состоянии для элементов управления перекладиной. Дополнительные сведения см. в исходном коде, расположенном в папке VC\atlmfc\src\mfc установки Visual Studio.

Синтаксис

class CMFCReBar : public CPane

Участники

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

Имя Описание
CMFCReBar::AddBar Добавляет полосу на перекладку.
CMFCReBar::CalcFixedLayout (Переопределения CBasePane::CalcFixedLayout.)
CMFCReBar::CanFloat (Переопределения CBasePane::CanFloat.)
CMFCReBar::Create Создает элемент управления rebar и присоединяет его к объекту CMFCReBar .
CMFCReBar::EnableDocking (Переопределения CBasePane::EnableDocking.)
CMFCReBar::GetReBarBandInfoSize
CMFCReBar::GetReBarCtrl Предоставляет прямой доступ к базовому элементу управления CReBarCtrl .
CMFCReBar::OnShowControlBarMenu (Переопределения CPane::OnShowControlBarMenu.)
CMFCReBar::OnToolHitTest (Переопределения CWnd::OnToolHitTest.)
CMFCReBar::OnUpdateCmdUI (Переопределения CBasePane::OnUpdateCmdUI.)
CMFCReBar::SetPaneAlignment (Переопределения CBasePane::SetPaneAlignment.)

Замечания

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

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

Пример

В приведенном ниже примере демонстрируется использование различных методов класса CMFCReBar . В примере показано, как создать элемент управления перестроек и добавить в него полосу. Группа работает как внутренняя панель инструментов. Этот фрагмент кода является частью примера теста перебарки.

CMFCReBar m_wndReBar;

// Each rebar pane will ocupy its own row:
DWORD dwStyle = RBBS_GRIPPERALWAYS | RBBS_FIXEDBMP | RBBS_BREAK;
// CMFCMenuBar m_wndMenuBar
// CMFCToolBar m_wndToolBar
if (!m_wndReBar.Create(this) ||
    !m_wndReBar.AddBar(&m_wndMenuBar) ||
    !m_wndReBar.AddBar(&m_wndToolBar, NULL, NULL, dwStyle))
{
   TRACE0("Failed to create rebar\n");
   return -1; // fail to create
}

Иерархия наследования

CObject
└ CCmdTarget
 └ CWnd
  └ CBasePane
   └ CPane
    └ CMFCReBar

Требования

Заголовок: afxRebar.h

CMFCReBar::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
[in, out] Указатель на дочернее окно, которое необходимо вставить на панель перекладки. Указанный объект должен иметь стиль окна WS_CHILD .

pszText
[in] Указывает текст, отображаемый на панели. Текст не является частью дочернего окна. Скорее, он отображается на самой перекладиной.

pbmp
[in, out] Указывает растровое изображение, отображаемое в фоновом режиме на панели.

dwStyle
[in] Содержит стиль, применяемый к группе. Полный список стилей групп см. в описании fStyle структуры REBARBANDINFO в документации по Windows SDK.

clrFore
[in] Представляет цвет переднего плана панели.

clrBack
[in] Представляет цвет фона панели.

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

ЗНАЧЕНИЕ TRUE, если полоса успешно добавлена на панель; в противном случае — ЗНАЧЕНИЕ FALSE.

CMFCReBar::Create

Создает элемент управления rebar и присоединяет его к объекту CMFCReBar .

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
[in, out] Указатель на родительское окно этого элемента управления перебары.

dwCtrlStyle
[in] Задает стиль для элемента управления rebar. Значение стиля по умолчанию — RBS_BANDBORDERS, в котором отображаются узкие линии для разделения смежных полос на элементе управления перестроек. Список допустимых стилей см. в документации по пакету SDK для Windows.

dwStyle
[in] Стиль окна элемента управления rebar. Список допустимых стилей см. в разделе "Стили окон".

Nid
[in] Идентификатор дочернего окна панели.

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

ЗНАЧЕНИЕ TRUE, если панель была создана успешно; в противном случае — ЗНАЧЕНИЕ FALSE.

Замечания

CMFCReBar::GetReBarCtrl

Предоставляет прямой доступ к CReBarCtrl базовому общему элементу управления для CMFCReBar объектов.

CReBarCtrl& GetReBarCtrl() const;

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

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

Замечания

Вызовите этот метод, чтобы воспользоваться возможностями общей панели управления Windows при настройке панели.

CMFCReBar::CalcFixedLayout

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Параметры

[in] bStretch
[in] bHorz

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

Замечания

CMFCReBar::CanFloat

virtual BOOL CanFloat() const;

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

Замечания

CMFCReBar::EnableDocking

void EnableDocking(DWORD dwDockStyle);

Параметры

[in] dwDockStyle

Замечания

CMFCReBar::GetReBarBandInfoSize

UINT GetReBarBandInfoSize() const;

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

Замечания

CMFCReBar::OnShowControlBarMenu

virtual BOOL OnShowControlBarMenu(CPoint);

Параметры

[in] CPoint

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

Замечания

CMFCReBar::OnToolHitTest

virtual INT_PTR OnToolHitTest(
    CPoint point,
    TOOLINFO* pTI) const;

Параметры

[in] Точки
[in] Pti

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

Замечания

CMFCReBar::OnUpdateCmdUI

virtual void OnUpdateCmdUI(
    CFrameWnd* pTarget,
    BOOL bDisableIfNoHndler);

Параметры

[in] pTarget
[in] bDisableIfNoHndler

Замечания

CMFCReBar::SetPaneAlignment

virtual void SetPaneAlignment(DWORD dwAlignment);

Параметры

[in] dwAlignment

Замечания

См. также

Диаграмма иерархии
Классы
Класс CReBarCtrl
Класс CPane