Класс 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