Поделиться через

Класс CDialogBar

Примечание.

Библиотека классов Microsoft Foundation (MFC) продолжает поддерживаться. Однако мы больше не добавляем функции или обновляем документацию.

Предоставляет функциональные возможности немодального диалогового окна 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 Studio см. в статье "Использование пользовательского элемента управления 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

  • Last updated on