CToolBar::Create

Artigo
06/10/2015

Essa função de membro cria uma barra de ferramentas do windows (uma janela filho) e o associa a objeto de CToolBar .

virtual BOOL Create( 
   CWnd* pParentWnd, 
   DWORD dwStyle = WS_CHILD |   WS_VISIBLE | CBRS_TOP, 
   UINT nID = AFX_IDW_TOOLBAR  
);

Parâmetros

pParentWnd
Ponteiro para a janela que é o pai da barra de ferramentas.
dwStyle
O estilo da barra de ferramentas. Os estilos adicionais da barra de ferramentas são suportados:
- a barra de controle deCBRS_TOP é em auge da janela do quadro.
- a barra de controle deCBRS_BOTTOM está na parte inferior da janela do quadro.
- a barra de controle deCBRS_NOALIGN não é reposicionada quando o pai é redimensionado.
- a barra de controle deCBRS_TOOLTIPS exibe a dica de ferramenta.
- a barra de controle deCBRS_SIZE_DYNAMIC é dinâmico.
- A barra de controle deCBRS_SIZE_FIXED é fixa.
- A barra de controle deCBRS_FLOATING está flutuantes.
- a barra de status deCBRS_FLYBY exibe informações sobre o botão.
- A barra de controle deCBRS_HIDE_INPLACE não é exibido para o usuário.
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.

Exemplo

// This code fragment is taken from CMainFrame::OnCreate 
// CMainFrame is derived from CMDIFrameWnd. 

//This example creates a dockable toolbar. 
if (!m_wndToolBar.Create(this) ||
   !m_wndToolBar.LoadToolBar(IDR_MAINFRAME))
{
   TRACE0("Failed to create toolbar\n");
   return -1;      // fail to create
}

//Make the toolbar dockable
m_wndToolBar.EnableDocking(CBRS_ALIGN_ANY);
EnableDocking(CBRS_ALIGN_ANY);
DockControlBar(&m_wndToolBar);