Partilhar via


CToolBar::CreateEx

telefonar Esta função para criar uma barra de ferramentas do Windows (uma janela filho) e associá-lo com o CToolBar objeto.

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 é pai da barra de ferramentas.

  • dwCtrlStyle
    Estilos adicionais para a criação do incorporados CToolBarCtrl objeto.Por padrão, esse valor é conjunto para TBSTYLE_FLAT.Para obter uma lista completa dos estilos de barra de ferramentas, consulte dwStyle.

  • dwStyle
    O estilo de barra de ferramentas.See Controle de barra de ferramentas e estilos de botão in the Windows SDK Para obter uma lista de estilos apropriados.

  • rcBorders
    A CRect objeto que define a largura das bordas da janela da barra de ferramentas.Essas áreas são definidas como 0,0,0,0 por padrão, assim, resultando em uma janela de barra de ferramentas com nenhuma borda.

  • nID
    ID da janela filho. da barra de ferramentas

Valor de retorno

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

Comentários

Ele 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 presente durante a criação do controle de BAR de ferramenta incorporada.Por exemplo, conjunto dwCtrlStyle para TBSTYLE_FLAT | TBSTYLE_TRANSPARENT para criar uma barra de ferramentas que se parece com as barras de ferramentas do Internet Explorer 4.

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 de hierarquia

Outros recursos

CToolBar membros