CToolBarCtrl::criar

Artigo
08/25/2010

Cria um controle de barra de ferramentas e a anexa um CToolBarCtrl objeto.

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

Parâmetros

dwStyle
Especifica o estilo de controle de barra de ferramentas.Barras de ferramentas sempre devem ter o WS_CHILD estilo.Além disso, você pode especificar qualquer combinação de estilos de barra de ferramentas e sistema autônomo estilos de janela conforme descrito em Comentários.
rect
Especifica opcionalmente o dimensionar e posição do controle de barra de ferramentas.Pode ser qualquer um CRect objeto ou um RECT estrutura.
pParentWnd
Especifica a janela pai do controle de barra de ferramentas.Não deve ser NULO.
nID
Especifica a ID. do controle de barra de ferramentas

Valor de retorno

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

Comentários

Construir um CToolBarCtrl em duas etapas. Primeiro, telefonar construtor e, em seguida, telefonar Criar, que cria o controle de barra de ferramentas e a anexa à CToolBarCtrl objeto. Aplica os seguintes estilos de janela a um controle de barra de ferramentas.

WS_CHILD Sempre
WS_VISIBLE Em geral
WS_DISABLED Raramente

See CreateWindow in the Windows SDK Para obter uma descrição dos estilos de janela.

Opcionalmente, aplicar uma combinação de estilos de controle comuns, sistema autônomo descrito o Windows SDK.

Aplicar uma combinação de estilos de barra de ferramentas para o controle ou os botões de si mesmos.Os estilos são descritos o tópico Controle de barra de ferramentas e estilos de botão in the Windows SDK.

Para usar estilos estendidos barra de ferramentas, telefonar SetExtendedStyle após chamar Criar.Para criar uma barra de ferramentas com estilos de janela estendida, chamar CToolBarCtrl::CreateEx em vez de Criar.

O controle de barra de ferramentas automaticamente define o dimensionar e a posição da janela de barra de ferramentas.A altura é com base na altura dos botões na barra de ferramentas.A largura é a mesma que a largura da área de cliente da janela pai.The CCS_TOP e CCS_BOTTOM estilos de determinam se a barra de ferramentas é posicionada ao longo da parte superior ou inferior da área de cliente. Por padrão, uma barra de ferramentas possui o CCS_TOP estilo.