Classe de CToolBar

Artigo
03/15/2013

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

class CToolBar : public CControlBar

Membros

Construtores public

Nome	Descrição
CToolBar::CToolBar	Constrói um objeto de CToolBar .

Métodos públicos

Nome	Descrição
CToolBar::CommandToIndex	Retorna o índice de um botão com a identificação determinada de comando
CToolBar::Create	Cria a barra de ferramentas do windows e anexá-la ao objeto de CToolBar .
CToolBar::CreateEx	Cria um objeto de CToolBar com os estilos adicionais para o objeto inserido de CToolBarCtrl .
CToolBar::GetButtonInfo	Obtém a identificação, o estilo, e o número de imagem de um botão.
CToolBar::GetButtonStyle	Recupera o estilo de um botão.
CToolBar::GetButtonText	Recupera o texto que aparecerá em um botão.
CToolBar::GetItemID	Retorna a identificação de comando de um botão ou um separador no índice especificado.
CToolBar::GetItemRect	Recupera o retângulo de exibição para o item no índice especificado.
CToolBar::GetToolBarCtrl	Permite acesso direto ao controle comum subjacente.
CToolBar::LoadBitmap	Carrega o bitmap que contém imagens de bitmap- botão.
CToolBar::LoadToolBar	Carrega um recurso da barra de ferramentas criado com o editor de recursos.
CToolBar::SetBitmap	Define uma imagem bitmap.
CToolBar::SetButtonInfo	Define a identificação, o estilo, e o número de imagem de um botão.
CToolBar::SetButtons	Define um estilo e um índice do botão imagens de bitmap em.
CToolBar::SetButtonStyle	Defina o estilo de um botão.
CToolBar::SetButtonText	Define o texto que aparecerá em um botão.
CToolBar::SetHeight	Defina a altura da barra de ferramentas.
CToolBar::SetSizes	Defina os tamanhos dos botões e seus bitmaps.

Comentários

Os botões podem atuar como teclas, botões da caixa de seleção, ou botões de opção.Os objetos deCToolBar geralmente são membros de objetos inseridos de quadro- janela derivados da classe CFrameWnd ou CMDIFrameWnd.

CToolBar::GetToolBarCtrl, uma função de membro novo a MFC 4,0, permite que você aproveite de suporte comuns de controle do windows para personalização e funcionalidade adicional da barra de ferramentas.As funções de membro deCToolBar dão-no mais da funcionalidade dos controles comuns do windows; no entanto, quando você chama GetToolBarCtrl, você pode dar às barras de ferramentas ainda mais das características Windows 95 /98 da barra de ferramentas.Quando você chama GetToolBarCtrl, retornará uma referência a um objeto de CToolBarCtrl .Consulte CToolBarCtrl para obter mais informações sobre como criar barras de ferramentas usando controles comuns.Para obter informações mais gerais sobre controles comuns, consulte Controles comuns em Windows SDK.

Visual C++ fornece dois métodos para criar uma barra de ferramentas.Para criar um recurso da barra de ferramentas usando o editor de recursos, siga estas etapas:

Crie um recurso da barra de ferramentas.
Construir o objeto de CToolBar .
Chame a função de Criar (ou CreateEx) para criar a barra de ferramentas do windows para e anexá-la ao objeto de CToolBar .
Chamada LoadToolBar para carregar o recurso da barra de ferramentas.

Caso contrário, siga estas etapas:

Construir o objeto de CToolBar .
Chame a função de Criar (ou CreateEx) para criar a barra de ferramentas do windows para e anexá-la ao objeto de CToolBar .
A chamada LoadBitmap para carregar o bitmap que contém o botão da barra de ferramentas imagens.
Chame SetButtons para definir o estilo do botão e para associar cada botão com uma imagem bitmap em.

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

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

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

Todos os botões na barra de ferramentas são o mesmo tamanho.O padrão é 24 x 22 pixels, de acordo com as diretrizes de interface do windows para o design de software.Qualquer espaço extra entre a imagem e as dimensões do botão é usado para formar uma borda ao redor da imagem.

Cada botão tem uma imagem.Vários estados e estilo de botão (pressionadas, cima, para baixo, de desativado, desativado para baixo, e indeterminado) são gerados da uma imagem.Embora bitmaps possam ser qualquer cor, você pode obter melhores resultados com imagens em preto e em tons de cinza.

Cuidado
CToolBar suporta bitmaps com um máximo de 16 cores.Quando você carregar uma imagem em um editor da barra de ferramentas, o Visual Studio automaticamente converte a imagem a um bitmap de cores 16 se necessário, e exibe uma mensagem de aviso se a imagem foi convertido.Se você usar uma imagem com as cores mais de 16 (usando um editor externo para editar a imagem), o aplicativo pode se comportar inesperado.

CToolBar suporta bitmaps com um máximo de 16 cores.Quando você carregar uma imagem em um editor da barra de ferramentas, o Visual Studio automaticamente converte a imagem a um bitmap de cores 16 se necessário, e exibe uma mensagem de aviso se a imagem foi convertido.Se você usar uma imagem com as cores mais de 16 (usando um editor externo para editar a imagem), o aplicativo pode se comportar inesperado.

Os botões da barra de ferramentas imitam teclas por padrão.Em o entanto, os botões da barra de ferramentas também pode imitar botões ou botões de opção na caixa de seleção.Botões da caixa de seleção têm três estados: verificado, desmarcado, e indefinido.Botões de opção só tem dois estados: verificadas e desmarcada.

Para definir um estilo individual do botão ou separator sem aponte para uma matriz, chame GetButtonStyle para recuperar o estilo, e então chame SetButtonStyle em vez de SetButtons.SetButtonStyle é mais útil quando você deseja alterar em tempo de execução o estilo de um botão.

Para atribuir texto para aparecer em um botão, chame GetButtonText para recuperar o texto para aparecer no botão, e então chame SetButtonText para definir o texto.

Para criar um botão da caixa de seleção, atribua o estilo TBBS_CHECKBOX ou use a função de membro de SetCheck de um objeto de CCmdUI em um manipulador de ON_UPDATE_COMMAND_UI .A chamada SetCheck torna uma tecla em um botão da caixa de seleção.SetCheck passar um argumento de 0 para não-verificada, 1 para verificado, ou 2 para indefinido.

Para criar um botão de opção, chame a função de membro de SetRadio de um objeto de CCmdUI de um manipulador de ON_UPDATE_COMMAND_UI .SetRadio passar um argumento de 0 para não-verificada ou diferente de zero para verificado.Para fornecer um comportamento mutuamente exclusivos de um grupo de rádio, você deve ter manipuladores de ON_UPDATE_COMMAND_UI para todos os botões no grupo.

Para obter mais informações sobre como usar CToolBar, consulte o artigo Implementação da barra de ferramentas MFC e Observe técnica 31: barras de controle.