Compartilhar via


CToolBarCtrl::Create

Cria um controle de barra de ferramentas e anexá-la a um objeto de CToolBarCtrl .

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

Parâmetros

  • dwStyle
    Especifica o estilo do controle de barra de ferramentas.As barras de ferramentas devem sempre ter o estilo de WS_CHILD .Além de isso, você pode especificar qualquer combinação de estilos da barra de ferramentas e de estilos de janela como descrito em Comentários.

  • rect
    Opcionalmente especificar o tamanho e a posição do controle de barra de ferramentas.Pode ser um objeto de CRect ou uma estrutura de RECT .

  • pParentWnd
    Especifica a janela pai do controle de barra de ferramentas.Não deve ser NULO.

  • nID
    Especifica a identificação do controle de barra de ferramentas

Valor de retorno

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

Comentários

Você constrói CToolBarCtrl em duas etapas.Primeiro, o construtor, e então chame Criar, que cria o controle de barra de ferramentas e o anexar para o objeto de CToolBarCtrl .Aplicar os seguintes estilos de janela para um controle de barra de ferramentas.

  • WS_CHILD sempre

  • WS_VISIBLE geralmente

  • WS_DISABLED raramente

Consulte CreateWindow em Windows SDK para obter uma descrição de estilos de janela.

Opcionalmente, aplique uma combinação de estilos de controle comum, como descrito em Windows SDK.

Aplicar uma combinação de estilos da barra de ferramentas para o controle ou aos botões ele mesmo.Os estilos são descritos no tópico Estilos de controle toolbar e de botão em Windows SDK.

Para usar estilos estendidos da barra de ferramentas, chame SetExtendedStyle depois de você chamar Criar.Para criar uma barra de ferramentas com os estilos estendidos da janela, chame CToolBarCtrl::CreateEx em vez de Criar.

O controle de barra de ferramentas define automaticamente o tamanho e a posição da janela da barra de ferramentas.A altura é baseada na altura os botões da barra de ferramentas.A largura é a mesma que a largura da área cliente da janela pai.Os estilos de CCS_TOP e de CCS_BOTTOM determinar se a barra de ferramentas está posicionado na parte superior ou inferior da área cliente.Por padrão, uma barra de ferramentas tem o estilo de CCS_TOP .

Requisitos

Cabeçalho: afxcmn.h

Consulte também

Referência

Classe de CToolBarCtrl

Gráfico de hierarquia

CToolBarCtrl::CToolBarCtrl

CToolBarCtrl::SetButtonStructSize