CDialogBar::criar

Artigo
08/25/2010

Carrega o modelo de recurso de caixa de diálogo especificado por lpszTemplateName ou nIDTemplate, cria a janela de BAR da caixa de diálogo, define seu estilo e associa-lo com o CDialogBar objeto.

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 pai CWnd objeto.
lpszTemplateName
Um ponteiro para o nome do CDialogBar modelo de recurso de caixa de diálogo do objeto.
nStyle
O estilo de alinhamento do BAR de diálogo.Há suporte para os seguintes estilos:
- CBRS_TOP BAR de controle está na parte superior da janela do quadro.
- CBRS_BOTTOM BAR de controle está na parte inferior da janela do quadro.
- CBRS_NOALIGN BAR de controle não é reposicionado quando o pai é redimensionado.
- CBRS_LEFT BAR de controle é da esquerda da janela do quadro.
- CBRS_RIGHT BAR de controle está no canto direito da janela do quadro.
nID
A ID de controle do BAR de diálogo.
nIDTemplate
A ID do recurso do CDialogBar modelo de caixa de diálogo do objeto.

Valor de retorno

Diferente de zero se bem-sucedida; caso contrário, 0.

Comentários

Se você especificar o CBRS_TOP ou CBRS_BOTTOM estilo de alinhamento, a largura BAR de diálogo's é que da janela do quadro e a altura é que o recurso especificado por nIDTemplate. Se você especificar o CBRS_LEFT ou CBRS_RIGHT estilo de alinhamento, altura da BAR de diálogo é que o da janela do quadro e a largura é que o recurso 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;
}