Класс CDialogBar

Предоставляет функциональные возможности немодального диалогового окна Windows на панели элементов управления.

Синтаксис

class CDialogBar : public CControlBar

Участники

Открытые конструкторы

Имя	Описание
CDialogBar::CDialogBar	Формирует объект CDialogBar.

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

Имя	Описание
CDialogBar::Create	Создает диалоговое окно Windows и присоединяет его к объекту CDialogBar .

Замечания

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

Создание и использование диалоговой CFormView строки аналогично созданию и использованию объекта. Во-первых, используйте редактор диалогов для определения шаблона диалогового окна со стилем WS_CHILD и без другого стиля. Шаблон не должен содержать стиль WS_VISIBLE. В коде приложения вызовите конструктор, чтобы создать CDialogBar объект, а затем вызовите Create окно диалоговой строки и подключите его к объекту CDialogBar .

Дополнительные сведения CDialogBarсм. в статьях "Панели диалогов " и технические заметки 31, панели управления.

Примечание.

В текущем выпуске CDialogBar объект не может размещать элементы управления Windows Forms. Дополнительные сведения об элементах управления Windows Forms в Visual C++см. в разделе "Использование пользовательского элемента управления Windows Form в MFC".

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

CObject

CCmdTarget

CWnd

Ccontrolbar

CDialogBar

Требования

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

CDialogBar::CDialogBar

Формирует объект CDialogBar.

CDialogBar();

CDialogBar::Create

Загружает шаблон ресурса диалогового окна, указанный lpszTemplateName или nIDTemplateсоздает окно диалоговой строки, задает его стиль и связывает его с CDialogBar объектом.

virtual BOOL Create(
    CWnd* pParentWnd,
    LPCTSTR lpszTemplateName,
    UINT nStyle,
    UINT nID);

virtual BOOL Create(
    CWnd* pParentWnd,
    UINT nIDTemplate,
    UINT nStyle,
    UINT nID);

Параметры

pParentWnd
Указатель на родительский CWnd объект.

lpszTemplateName
Указатель на имя шаблона ресурса диалогового CDialogBar окна объекта.

nStyle
Стиль панели инструментов. Поддерживаются дополнительные стили панели инструментов:

• CBRS_TOP панель управления находится в верхней части окна фрейма.

• CBRS_BOTTOM панель управления находится в нижней части окна фрейма.

• CBRS_NOALIGN панель управления не перемещается при изменении размера родительского элемента.

• CBRS_TOOLTIPS панель управления отображает подсказки инструментов.

• панель управления CBRS_SIZE_DYNAMIC является динамической.

• CBRS_SIZE_FIXED панель управления исправлена.

• CBRS_FLOATING панель управления плавает.

• CBRS_FLYBY строке состояния отображаются сведения о кнопке.

• CBRS_HIDE_INPLACE панель управления не отображается пользователю.

Nid
Идентификатор элемента управления диалоговой строки.

nIDTemplate
Идентификатор ресурса шаблона диалогового CDialogBar окна объекта.

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

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

Замечания

Если указать стиль выравнивания CBRS_TOP или CBRS_BOTTOM, ширина окна диалогового окна и ее высота — это ресурс, указанный nIDTemplate. Если указать стиль выравнивания CBRS_LEFT или CBRS_RIGHT, высота диалоговой строки равна ширине окна фрейма, а ее ширина — ресурсу , указанному nIDTemplate.

Пример

int CMainFrame::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
   if (CMDIFrameWnd::OnCreate(lpCreateStruct) == -1)
      return -1;

   EnableDocking(CBRS_ALIGN_ANY);

   // m_wndDlgBar is a CDialogBar member of CMainFrame
   // IDD_DIALOGBAR - Resource ID of the dialog
   // template. This dialog template should be created
   // with  the  style  WS_CHILD and no other style.
   // The template must not have the style WS_VISIBLE.
   if (!m_wndDlgBar.Create(this, IDD_DIALOGBAR,
                           CBRS_LEFT | CBRS_TOOLTIPS | CBRS_FLYBY, IDD_DIALOGBAR))
   {
      TRACE0("Failed to create DlgBar\n");
      return -1; // Fail to create.
   }

   return 0;
}

См. также

Пример КЛАВИШ CTRLBARS MFC
Класс CControlBar
Диаграмма иерархии
Класс CFormView
Класс CControlBar