Методы DockControlBar и FloatControlBar класса CFrameWnd
Чтобы пристыковать панель управления к границе окна, надо вызвать метод DockControlBar класса CFrameWnd:
void
DockControlBar(
CControlBar * pBar,
UINT nDockBarID = 0,
LPCRECT lpRect = NULL
);
Панель управления, заданная параметром pBar, пристыковывается к границе окна, указанной параметром nDockBarID. В качестве nDockBarID можно использовать один или несколько флагов, перечисленных ниже.
| Флаг | Описание |
| |
| AFX_IDW_DOCKBAR_TOP | Панель управления присоединяется к верхней границе окна | ||
| AFX_IDW_DOCKBAR_BOTTOM | Панель управления присоединяется к нижней границе окна | ||
| AFX_IDW_DOCKBAR_LEFT | Панель управления присоединяется к левой границе окна | ||
| AFX_IDW_DOCKBAR_RIGHT | Панель управления присоединяется к правой границе окна |
Если параметр nDockBarID равен нулю, то панель управления присоединяется к любой стороне окна.
Как видите, параметр nDockBarID может задавать несколько сторон окна одновременно. В этом случае панель управления присоединяется к той границе окна, которая одновременно указана методами CFrameWnd::EnableDocking и CControlBar::EnableDocking. Если таких границ несколько, то они выбираются в следующем порядке - сначала верхняя, а если к ней панель не может быть присоединена, тогда нижняя, левая, и правая стороны окна.
Последний параметр lpRect определяет, где именно будет отображаться панель управления. Положение панели задается в экранных координатах.
Если вам надо отобразить панель управления в отдельном мини-окне и не пристыковывать его к границам окна, то вместо метода DockControlBar вызовите метод FloatControlBar класса CFrameWnd:
CFrameWnd*
FloatControlBar(
CControlBar * pBar,
CPoint point
);
Панель управления, указанная параметром pBar, отображается в отдельном мини-окне. Расположение окна панели управления задается параметром point, который указывает координаты верхнего левого угла панели управления. Используются экранные координаты.
Метод FloatControlBar возвращает указатель на текущее окно.
По умолчанию, панель управления не имеет заголовка. Для установки и изменения текста заголовка используйте метод SetWindowText, определенный в классе CWnd:
void SetWindowText(LPCTSTR lpszString);
Параметр lpszString должен содержать указатель на объект класса CString или строку символов, закрытую двоичным нулем. В ней должен быть записан заголовок для панели управления.
