CDialogBar::Create

Статья
02/20/2013

Загружает заданный шаблон ресурса диалогового окна 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;
}