Compartir a través de


CToolBarCtrl::Create

Crea un control de barra de herramientas y lo asocia a un objeto de CToolBarCtrl .

virtual BOOL Create(
   DWORD dwStyle,
   const RECT& rect,
   CWnd* pParentWnd,
   UINT nID 
);

Parámetros

  • dwStyle
    Especifica el estilo de control toolbar.Las barras de herramientas siempre deben tener el estilo de WS_CHILD .Además, puede especificar cualquier combinación de estilos y de estilos de ventana de la barra de herramientas como se describe en Comentarios.

  • rect
    Especifica opcionalmente el tamaño y la posición del control de barra de herramientas.puede ser un objeto de CRect o una estructura de RECT .

  • pParentWnd
    Especifica la ventana principal del control de barra de herramientas.no debe ser NULL.

  • nID
    Especifica el identificador de control toolbar

Valor devuelto

Distinto de cero si correctamente; si no cero.

Comentarios

Crea CToolBarCtrl en dos pasos.Primero, llame al constructor, y llame a Create, que hace que el control de barra de herramientas y lo asocia al objeto de CToolBarCtrl .Se aplican los estilos de ventana siguientes a un control toolbar.

  • WS_CHILD siempre

  • WS_VISIBLE normalmente

  • WS_DISABLED raramente

Vea CreateWindow en Windows SDK para obtener una descripción de estilos de ventana.

Opcionalmente, aplique una combinación de estilos de controles comunes, como se describe en Windows SDK.

Aplica una combinación de la barra de herramientas al control o los botones propios.Los estilos se describen en el tema Control toolbar y estilos de botón en Windows SDK.

Para utilizar estilos extendidos de la barra de herramientas, llame a SetExtendedStyle después de llamar a Create.Para crear una barra de herramientas con estilos de ventana extendidas, llame a CToolBarCtrl::CreateEx en lugar de Create.

El control toolbar establece automáticamente el tamaño y la posición de la ventana de la barra de herramientas.El alto se basa en el alto de los botones de la barra de herramientas.El ancho es igual que el ancho del área de cliente de la ventana primaria.Los estilos de CCS_TOP y de CCS_BOTTOM determinan si la barra de herramientas está colocado a lo largo de la parte superior o inferior del área cliente.De forma predeterminada, una barra de herramientas tiene el estilo de CCS_TOP .

Requisitos

encabezado: afxcmn.h

Vea también

Referencia

Clase de CToolBarCtrl

Gráfico de jerarquía

CToolBarCtrl::CToolBarCtrl

CToolBarCtrl::SetButtonStructSize