Classe CToolBar

Barras de controle que tem uma linha de botões de bitmap e separadores opcionais.

class CToolBar : public CControlBar

Comentários

Os botões podem agir como pushbuttons, botões da caixa de seleção ou botões de opção.CToolBar os objetos são normalmente incorporados membros dos objetos da janela do quadro derivados da classe CFrameWnd or CMDIFrameWnd.

CToolBar::GetToolBarCtrl, uma função de membro novo no MFC 4.0, permite que você aproveite o suporte a Windows comuns do controle para personalização da barra de ferramentas e recursos adicionais.CToolBar funções de membro lhe dão a maioria da funcionalidade dos controles comuns Windows; no entanto, quando você telefonar GetToolBarCtrl, você pode permitir que as barras de ferramentas ainda mais as características das barras de ferramentas do Windows 95/98. Quando você telefonar GetToolBarCtrl, ela retornará uma referência a um CToolBarCtrl objeto. See CToolBarCtrl para obter mais informações sobre como criar barras de ferramentas usando controles comuns do Windows.Para obter mais informações sobre controles comuns, consulte Controles comuns in the Windows SDK.

O Visual C++ fornece dois métodos para criar uma barra de ferramentas.Para criar um recurso de barra de ferramentas usando o Resource Editor, execute as seguintes etapas:

  1. Crie um recurso da barra de ferramentas.

  2. Construir o CToolBar objeto.

  3. Chamar o Criar (or CreateEx) função para criar a barra de ferramentas da Windows e anexá-lo à CToolBar objeto.

  4. De telefonarLoadToolBar para carregar o recurso de barra de ferramentas.

Caso contrário, siga estas etapas:

  1. Construir o CToolBar objeto.

  2. Chamar o Criar (or CreateEx) função para criar a barra de ferramentas da Windows e anexá-lo à CToolBar objeto.

  3. De telefonarLoadBitmap para carregar o bitmap que contém as imagens de botão de barra de ferramentas.

  4. De telefonarSetButtons para conjunto o estilo de botão e associar cada botão uma imagem em bitmap.

Todas as imagens de botão na barra de ferramentas são obtidas de um bitmap, que deve conter uma imagem para cada botão.Todas as imagens devem ser do mesmo dimensionar; o padrão é 16 pixels de largura e 15 pixels de altura.Imagens devem estar lado a lado no bitmap.

The SetButtons função leva um ponteiro para uma matriz de IDs de controle e um número inteiro que especifica o número de elementos na matriz. A função define a ID de cada botão como o valor do elemento correspondente da matriz e atribui um índice de imagem, que especifica a posição da imagem do botão no bitmap de cada botão.Se um elemento de matriz tem o valor ID_SEPARATOR, não há índice de imagens é atribuído.

A ordem das imagens no bitmap é normalmente a ordem na qual eles são desenhados na tela, mas você pode usar o SetButtonInfofunção para alterar a relação entre a ordem de imagem e a ordem de desenho.

Todos os botões na barra de ferramentas são do mesmo dimensionar.O padrão é 24 x 22 pixels, de acordo com Windows Interface Guidelines for Software Design.Qualquer espaço adicional entre as dimensões de imagem e o botão é usado para formar uma borda ao redor da imagem.

Cada botão possui uma imagem.Os diversos estados de botão e estilos (down pressionado, indeterminado desativado e desabilitado para baixo) são gerados de que uma imagem.Embora bitmaps podem ser qualquer cor, você pode obter os melhores resultados com imagens em preto e tons de cinza.

Botões da barra de ferramentas imitar pushbuttons por padrão.No entanto, botões da barra de ferramentas também podem imitar a botões da caixa de seleção ou botões de opção.Botões da caixa de seleção tem três estados: marcada, desmarcada e indeterminado.Botões de opção têm apenas dois estados: marcada e desmarcada.

Para conjunto um botão individual ou separador de estilo sem apontando para uma matriz, telefonar GetButtonStyle para recuperar o estilo e, em seguida, telefonar SetButtonStyle em vez de SetButtons. SetButtonStyle é mais útil quando você deseja alterar o estilo do botão em time de execução.

Para atribuir texto a ser exibido em um botão, telefonar GetButtonText para recuperar o texto a ser exibido no botão e, em seguida, telefonar SetButtonText para conjunto o texto.

Para criar um botão de caixa de seleção, atribua o estilo de TBBS_CHECKBOX or use a CCmdUI objeto SetCheck função de membro em um ON_UPDATE_COMMAND_UI manipulador. De chamadaSetCheck um pushbutton se transforma em um botão de caixa de seleção. Passar SetCheck um argumento de 0 para 1 estiver desmarcada, para o marcado ou 2 para indeterminado.

To create a radio button, call a CCmdUI object's SetRadio member function from an ON_UPDATE_COMMAND_UI handler.Passar SetRadio Verificado se um argumento de 0 para não-verificado ou diferente de zero para. Para fornecer um comportamento mutuamente exclusivas de um agrupar de opção, você deve ter ON_UPDATE_COMMAND_UI manipuladores para todos os botões no agrupar.

Para obter mais informações sobre como usar CToolBar, consulte o artigo Implementação de barra de ferramentas do MFC and 31 De observação técnica: Barras de controle.

Requisitos

Cabeçalho: afxext.h

Consulte também

Tarefas

Exemplo CTRLBARS: Ilustra barras de Controlarar Personalizar

Exemplo de DLGCBR32: Demonstra a adição de um barra de status e a barra de ferramentas a caixas de Caixa de diálogo

Exemplo DOCKTOOL: Demonstra Encaixável barras de ferramentas

Referência

Classe CControlBar

Gráfico de hierarquia

Classe CToolBarCtrl

Classe CControlBar

CToolBar::criar

CToolBar::LoadBitmap

CToolBar::SetButtons

CCmdUI::SetCheck

CCmdUI::SetRadio

Outros recursos

CToolBar membros