CToolBar::criar

Artigo
08/25/2010

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

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 é pai da barra de ferramentas.
dwStyle
O estilo de barra de ferramentas.Estilos de barra de ferramentas adicionais com suporte são:
- CBRS_TOP BAR de controle está na parte superior da janela do quadro.
- CBRS_BOTTOM BAR de controle está na parte inferior da janela do quadro.
- CBRS_NOALIGN BAR de controle não é reposicionado quando o pai é redimensionado.
- CBRS_TOOLTIPS BAR de controle Exibe dicas de ferramenta.
- CBRS_SIZE_DYNAMIC BAR de controle é dinâmico.
- CBRS_SIZE_FIXED BAR de controle é fixo.
- CBRS_FLOATING BAR de controle está flutuante.
- CBRS_FLYBY BAR de status exibe informações sobre o botão.
- CBRS_HIDE_INPLACE BAR de controle não é exibida ao usuário.
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.

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