CDialogBar::Create

Статья
06/10/2015

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