CToolBar::CreateEx

Artigo
06/10/2015

Chamar essa função para criar uma barra de ferramentas do windows (uma janela filho) e para associá-la com o objeto de CToolBar .

virtual BOOL CreateEx( 
   CWnd* pParentWnd, 
   DWORD dwCtrlStyle = TBSTYLE_FLAT, 
   DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_ALIGN_TOP, 
   CRect rcBorders = CRect( 
   0, 
   0, 
   0, 
   0 
), 
   UINT nID = AFX_IDW_TOOLBAR 
);

Parâmetros

pParentWnd
Ponteiro para a janela que é o pai da barra de ferramentas.
dwCtrlStyle
Os estilos adicionais para a criação de CToolBarCtrl objeto inserido. Por padrão, esse valor é definido como TBSTYLE_FLAT. Para obter uma lista completa de estilos da barra de ferramentas, consulte dwStyle.
dwStyle
O estilo da barra de ferramentas. Consulte Estilos de controle toolbar e de botão em Windows SDK para obter uma lista de estilos apropriadas.
rcBorders
Um objeto de CRect que define as larguras das bordas da janela da barra de ferramentas. Essas bordas são definidas como 0,0,0,0 por padrão, essa forma resultando em uma janela da barra de ferramentas sem bordas.
nID
Identificação da janela filho da barra de ferramentas

Valor de retorno

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

Comentários

Também define a altura da barra de ferramentas para um valor padrão.

Use CreateEx, em vez de Criar, quando determinados estilos precisam estar presentes durante a criação do controle inserido toolbar. Por exemplo, definir dwCtrlStyle a TBSTYLE_FLAT | TBSTYLE_TRANSPARENT para criar uma barra de ferramentas que lembra o Internet Explorer 4 barras de ferramentas.

Exemplo

// This example demonstrates CToolBar::CreateEx by creating a  
// toolbar as part of a child frame window. It also calls the  
// LoadToolbar and EnableDocking functions 
int CChildFrame::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
   if (CMDIChildWnd::OnCreate(lpCreateStruct) == -1)
      return -1;

   if (!m_wndMyToolBar.CreateEx(this, TBSTYLE_FLAT, WS_CHILD | WS_VISIBLE | CBRS_TOP
      | CBRS_GRIPPER | CBRS_TOOLTIPS | CBRS_FLYBY | CBRS_SIZE_DYNAMIC) ||
      !m_wndMyToolBar.LoadToolBar(IDR_MYTOOLBAR))
   {
      TRACE0("Failed to create toolbar\n");
      return -1;      // fail to create
   }

   m_wndMyToolBar.EnableDocking(CBRS_ALIGN_ANY);
   EnableDocking(CBRS_ALIGN_ANY);
   DockControlBar(&m_wndMyToolBar);

   return 0;
}

Requisitos

Cabeçalho: afxext.h

Consulte também

Referência

Classe CToolBar

Gráfico da hierarquia

Compartilhar via