CDialogBar::Create

Artículo
06/10/2015

Carga la plantilla del recurso de cuadro de diálogo especificada por lpszTemplateName o nIDTemplate, crea la ventana de la barra de cuadro de diálogo, establezca el estilo, y lo asocia al 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
Un puntero al objeto primario de CWnd .
lpszTemplateName
Un puntero al nombre de la plantilla del recurso de cuadro de diálogo del objeto de CDialogBar .
nStyle
el estilo de la barra de herramientas. los estilos adicionales de la barra de herramientas admitidos son:
- Barra de control deCBRS_TOP está en la parte superior de la ventana de marco.
- Barra de control deCBRS_BOTTOM está en la parte inferior de la ventana de marco.
- Barra de control deCBRS_NOALIGN no cambia de posición cuando se cambia el tamaño del elemento primario.
- Barra de control deCBRS_TOOLTIPS muestra información sobre herramientas.
- Barra de control deCBRS_SIZE_DYNAMIC es dinámica.
- Se corrige la barra de control deCBRS_SIZE_FIXED .
- Barra de control deCBRS_FLOATING flota.
- La barra de estado deCBRS_FLYBY muestra información sobre el botón.
- Barra de control deCBRS_HIDE_INPLACE no se muestra al usuario.
nID
El identificador de control de la barra de cuadro de diálogo.
nIDTemplate
El Id. de recurso de plantilla de cuadro de diálogo del objeto de CDialogBar .

Valor devuelto

Distinto de cero si correctamente; si no 0.

Comentarios

Si especifica el estilo de la alineación de CBRS_TOP o de CBRS_BOTTOM , el ancho de la barra de cuadro diálogo es el de la ventana de marco y el alto es el del recurso especificado por nIDTemplate. Si especifica el estilo de la alineación de CBRS_LEFT o de CBRS_RIGHT , el alto de la barra de cuadro diálogo es el de la ventana de marco y su ancho es el del recurso especificado por nIDTemplate.

Ejemplo

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