CDialogBar::Create

Artigo
02/25/2013

Carrega o modelo de recurso da caixa de diálogo especificado por lpszTemplateName ou por nIDTemplate, crie a janela da caixa de diálogo- barra, defina o estilo, e associá-la com o objeto de CDialogBar .

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

Parâmetros

pParentWnd
Um ponteiro para o objeto pai de CWnd .
lpszTemplateName
Um ponteiro para o nome do modelo de recurso da caixa de diálogo de objeto de CDialogBar .
nStyle
O estilo da barra de ferramentas.Os estilos adicionais da barra de ferramentas são suportados:
- a barra de controle deCBRS_TOP é em auge da janela do quadro.
- a barra de controle deCBRS_BOTTOM está na parte inferior da janela do quadro.
- a barra de controle deCBRS_NOALIGN não é reposicionada quando o pai é redimensionado.
- a barra de controle deCBRS_TOOLTIPS exibe a dica de ferramenta.
- a barra de controle deCBRS_SIZE_DYNAMIC é dinâmico.
- A barra de controle deCBRS_SIZE_FIXED é fixa.
- A barra de controle deCBRS_FLOATING está flutuantes.
- a barra de status deCBRS_FLYBY exibe informações sobre o botão.
- A barra de controle deCBRS_HIDE_INPLACE não é exibido para o usuário.
nID
A identificação de O controle de barra da caixa de diálogo.
nIDTemplate
A identificação de recurso do modelo da caixa de diálogo de objeto de CDialogBar .

Valor de retorno

Diferente de zero se com êxito; se não 0.

Comentários

Se você especificar o estilo de alinhamento de CBRS_TOP ou de CBRS_BOTTOM , a largura da barra da caixa de diálogo é a da janela do quadro e sua altura é que o recurso especificado por nIDTemplate.Se você especificar o estilo de alinhamento de CBRS_LEFT ou de CBRS_RIGHT , altura da barra da caixa de diálogo é a da janela do quadro e sua largura de recurso que é especificado por nIDTemplate.

Exemplo

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;
}