Classe CToolBarCtrl

Artigo
06/10/2015

Fornece a funcionalidade do controle comum da barra de ferramentas do windows.

class CToolBarCtrl : public CWnd

Membros

Construtores public

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

Métodos públicos

Nome	Descrição
CToolBarCtrl::AddBitmap	Adiciona uma ou mais imagens do botão de bitmap à lista de imagens do botão disponíveis para um controle de barra de ferramentas.
CToolBarCtrl::AddButtons	Adiciona um ou mais botões a um controle de barra de ferramentas.
CToolBarCtrl::AddString	Adiciona uma nova cadeia de caracteres, passada como um ID de recurso, a lista interna da barra de ferramentas de cadeias de caracteres.
CToolBarCtrl::AddStrings	Adiciona uma nova cadeia de caracteres ou cadeias de caracteres, passada como um ponteiro para um buffer de cadeias de caracteres NULL- separada, a lista interna da barra de ferramentas de cadeias de caracteres.
CToolBarCtrl::AutoSize	Redimensiona um controle de barra de ferramentas.
CToolBarCtrl::ChangeBitmap	Altera o bitmap de um botão no controle de barra de ferramentas atual.
CToolBarCtrl::CheckButton	Verifica ou limpa um determinado botão em um controle de barra de ferramentas.
CToolBarCtrl::CommandToIndex	Retorna o índice com base zero para o botão associado com o identificador de comando especificado.
CToolBarCtrl::Create	Cria um controle de barra de ferramentas e anexá-la a um objeto de CToolBarCtrl .
CToolBarCtrl::CreateEx	Cria um controle de barra de ferramentas com os estilos estendidos o windows especificados e anexá-la a um objeto de CToolBarCtrl .
CToolBarCtrl::Customize	Exibe a caixa de diálogo da barra de ferramentas personalizar.
CToolBarCtrl::DeleteButton	Exclui um botão de controle de barra de ferramentas.
CToolBarCtrl::EnableButton	Habilita ou desabilita o botão especificado em um controle de barra de ferramentas.
CToolBarCtrl::GetAnchorHighlight	Recupera a configuração de realce de âncora para uma barra de ferramentas.
CToolBarCtrl::GetBitmap	Retorna o índice de bitmap associado com um botão na barra de ferramentas.
CToolBarCtrl::GetBitmapFlags	Obtém os sinalizadores associados com o bitmap da barra de ferramentas.
CToolBarCtrl::GetButton	Recupera informações sobre o botão especificado em um controle de barra de ferramentas.
CToolBarCtrl::GetButtonCount	Recupera uma contagem dos botões no controle de barra de ferramentas.
CToolBarCtrl::GetButtonInfo	Recupera informações para um botão na barra de ferramentas.
CToolBarCtrl::GetButtonSize	Obtém a largura e altura atuais dos botões da barra de ferramentas, em pixels.
CToolBarCtrl::GetColorScheme	Recupera o esquema de cores de controle de barra de ferramentas atual.
CToolBarCtrl::GetDisabledImageList	Recupera a lista de imagem que um controle de barra de ferramentas usa para exibir os botões desativados.
CToolBarCtrl::GetDropTarget	Recupera a interface de IDropTarget para um controle de barra de ferramentas.
CToolBarCtrl::GetExtendedStyle	Recupera os estilos estendidos para um controle de barra de ferramentas.
CToolBarCtrl::GetHotImageList	Recupera a lista de imagem que um controle de barra de ferramentas usa para exibir os botões “quentes”. Um botão quente aparece realçado quando o ponteiro do mouse está acima de ele.
CToolBarCtrl::GetHotItem	Retorna o índice do item quente em uma barra de ferramentas.
CToolBarCtrl::GetImageList	Recupera a lista de imagem que um controle de barra de ferramentas usa para exibir os botões em seu estado padrão.
CToolBarCtrl::GetInsertMark	Recupera a marca de inserção atual para a barra de ferramentas.
CToolBarCtrl::GetInsertMarkColor	Recupera a cor usada para desenhar a marca de inserção para a barra de ferramentas.
CToolBarCtrl::GetItemRect	Recupera o retângulo delimitador de um botão em um controle de barra de ferramentas.
CToolBarCtrl::GetMaxSize	Retorna o tamanho total de todos os botões e separadores visíveis na barra de ferramentas.
CToolBarCtrl::GetMaxTextRows	Retorna o número máximo de linhas de texto exibido em um botão da barra de ferramentas.
CToolBarCtrl::GetMetrics	Recupera métricas de um controle de barra de ferramentas.
CToolBarCtrl::GetPadding	Recupera o preenchimento horizontal e vertical do controle de barra de ferramentas atual.
CToolBarCtrl::GetPressedImageList	Recupera a lista de imagem que o controle de barra de ferramentas atual usa para representar os botões o estado pressionado.
CToolBarCtrl::GetRect	Recupera o retângulo delimitador de um botão da barra de ferramentas especificado.
CToolBarCtrl::GetRows	Retorna o número de linhas de botões exibidos na barra de ferramentas.
CToolBarCtrl::GetState	Recupera informações sobre o estado do botão especificado em um controle de barra de ferramentas, como se estiver ativado, pressionado, ou verificado.
CToolBarCtrl::GetString	Recupera uma cadeia de caracteres de barra de ferramentas.
CToolBarCtrl::GetStyle	Recupera os estilos atualmentes em uso para um controle de barra de ferramentas.
CToolBarCtrl::GetToolTips	Recupera a alça de controle dica de ferramenta, se houver, associado ao controle de barra de ferramentas.
CToolBarCtrl::HideButton	Oculta ou mostra o botão especificado em um controle de barra de ferramentas.
CToolBarCtrl::HitTest	Determina onde um ponto está em um controle de barra de ferramentas.
CToolBarCtrl::Indeterminate	Define ou limpa o estado (cinza) indefinido do botão especificado em um controle de barra de ferramentas.
CToolBarCtrl::InsertButton	Insere um botão em um controle de barra de ferramentas.
CToolBarCtrl::InsertMarkHitTest	Recupera informações de marca para um ponto de inserção em uma barra de ferramentas.
CToolBarCtrl::IsButtonChecked	Informa se o botão especificado em um controle de barra de ferramentas é verificado.
CToolBarCtrl::IsButtonEnabled	Informa se o botão especificado em um controle de barra de ferramentas está habilitado.
CToolBarCtrl::IsButtonHidden	Informa se o botão especificado em um controle de barra de ferramentas está oculto.
CToolBarCtrl::IsButtonHighlighted	Verifica o estado de realce de botão da barra de ferramentas.
CToolBarCtrl::IsButtonIndeterminate	Informa se o estado do botão especificado em um controle de barra de ferramentas é indefinido (cinza).
CToolBarCtrl::IsButtonPressed	Informa se o botão especificado em um controle de barra de ferramentas está pressionada.
CToolBarCtrl::LoadImages	Bitmaps carrega a imagem de um controle de barra de ferramentas lista.
CToolBarCtrl::MapAccelerator	Mapeia um caractere de aceleradores a um botão da barra de ferramentas.
CToolBarCtrl::MarkButton	Define o estado de realce de um determinado botão em um controle de barra de ferramentas.
CToolBarCtrl::MoveButton	Move um botão de um índice para outro.
CToolBarCtrl::PressButton	Pressiona o botão ou versões especificado em um controle de barra de ferramentas.
CToolBarCtrl::ReplaceBitmap	Substitui o projeto existente no controle de barra de ferramentas atual com um novo projeto.
CToolBarCtrl::RestoreState	Restaura o estado do controle de barra de ferramentas.
CToolBarCtrl::SaveState	Salvar o estado do controle de barra de ferramentas.
CToolBarCtrl::SetAnchorHighlight	Define a configuração de realce de âncora para uma barra de ferramentas.
CToolBarCtrl::SetBitmapSize	Defina o tamanho das imagens bitmap a ser adicionadas a um controle de barra de ferramentas.
CToolBarCtrl::SetButtonInfo	Define informações de um botão existente em uma barra de ferramentas.
CToolBarCtrl::SetButtonSize	Defina o tamanho dos botões para ser adicionados a um controle de barra de ferramentas.
CToolBarCtrl::SetButtonStructSize	Especifica o tamanho da estrutura de TBBUTTON .
CToolBarCtrl::SetButtonWidth	Define o mínimo e máximo as larguras de botão no controle de barra de ferramentas.
CToolBarCtrl::SetCmdID	Define o identificador de comando para ser enviadas para a janela do proprietário quando o botão é pressionado especificado.
CToolBarCtrl::SetColorScheme	Defina o esquema de cores de controle de barra de ferramentas atual.
CToolBarCtrl::SetDisabledImageList	Define a lista de imagem que o controle de barra de ferramentas usará para exibir os botões desativados.
CToolBarCtrl::SetDrawTextFlags	Defina os sinalizadores na função DrawTextWin32, que é usada para desenhar texto no retângulo especificado, formatado de acordo com os sinalizadores são definidos como.
CToolBarCtrl::SetExtendedStyle	Define estilos estendidos para um controle de barra de ferramentas.
CToolBarCtrl::SetHotImageList	Define a lista de imagem que o controle de barra de ferramentas usará para exibir os botões “quentes”.
CToolBarCtrl::SetHotItem	Define o item quente em uma barra de ferramentas.
CToolBarCtrl::SetImageList	Define a lista de imagem que a barra de ferramentas usará para exibir botões que estão em seu estado padrão.
CToolBarCtrl::SetIndent	Define o recuo para o primeiro botão em um controle de barra de ferramentas.
CToolBarCtrl::SetInsertMark	Define a marca de inserção atual para a barra de ferramentas.
CToolBarCtrl::SetInsertMarkColor	Define a cor usada para desenhar a marca de inserção para a barra de ferramentas.
CToolBarCtrl::SetMaxTextRows	Define o número máximo de linhas de texto exibido em um botão da barra de ferramentas.
CToolBarCtrl::SetMetrics	Define métricas de um controle de barra de ferramentas.
CToolBarCtrl::SetOwner	Define a janela para receber notificações do controle de barra de ferramentas.
CToolBarCtrl::SetPadding	Define o preenchimento horizontal e vertical do controle de barra de ferramentas atual.
CToolBarCtrl::SetPressedImageList	Define a lista de imagem que o controle de barra de ferramentas atual usa para representar os botões o estado pressionado.
CToolBarCtrl::SetRows	Define o número de linhas de botões exibidos na barra de ferramentas.
CToolBarCtrl::SetState	Define o estado do botão especificado em um controle de barra de ferramentas.
CToolBarCtrl::SetStyle	Defina os estilos de um controle de barra de ferramentas.
CToolBarCtrl::SetToolTips	Associa um controle dica de ferramenta com o controle de barra de ferramentas.
CToolBarCtrl::SetWindowTheme	Defina o estilo visual de um controle de barra de ferramentas.

Comentários

Este controle (e portanto a classe de CToolBarCtrl ) estão disponíveis somente para programas que executam na versão 3,51 do /98 Windows 95 e Windows NT e posterior.

Um controle comum da barra de ferramentas do windows é uma janela filho retangular que contém um ou mais botões. Esses botões podem exibir uma imagem de bitmap, uma cadeia de caracteres, ou ambos. Quando o usuário escolhe um botão, envia uma mensagem de comando na janela do proprietário da barra de ferramentas. Normalmente, os botões na barra de ferramentas correspondem aos itens no menu de aplicativo; fornecem uma maneira mais direta para que o usuário acessa os comandos de um aplicativo.

Os objetos deCToolBarCtrl contêm várias estruturas de dados internas importantes: uma lista de bitmaps de imagem do botão ou uma lista de imagem, uma lista de cadeias de caracteres de rótulo do botão, e uma lista de estruturas de TBBUTTON que associam uma imagem e/ou uma cadeia de caracteres com a posição, suporta, indicam comando, e a identificação do botão. Cada um dos elementos de essas estruturas de dados é referenciado por um índice com base zero. Antes de usar um objeto de CToolBarCtrl , você deve configurar essas estruturas de dados. A lista de cadeias de caracteres somente pode ser usada para rótulos do botão; você não pode recuperar cadeias de caracteres de barra de ferramentas.

Para usar um objeto de CToolBarCtrl , você normalmente irá seguir estas etapas:

Construir o objeto de CToolBarCtrl .
Chame Criar para criar o controle comum da barra de ferramentas do windows para e anexá-la ao objeto de CToolBarCtrl . Indica o estilo da barra de ferramentas usando estilos, como TBSTYLE_TRANSPARENT para uma barra de ferramentas transparente ou TBSTYLE_DROPDOWN para uma barra de ferramentas que suporta os botões lista de estilo.
Identifica como você deseja que os botões na barra de ferramentas exibida:
- Para usar imagens de bitmap para adicionar botões, bitmaps de botão à barra de ferramentas chamando AddBitmap.
- Para usar imagens exibidas de uma imagem para listar os botões, especifique a lista de imagem chamando SetImageList, SetHotImageList, ou SetDisabledImageList.
- Para usar rótulos de cadeia de caracteres para os botões, adicione as cadeias de caracteres para a barra de ferramentas chamando AddString e/ou AddStrings.
Adicione estruturas de botão à barra de ferramentas chamando AddButtons.
Se você deseja dica de ferramenta para um botão da barra de ferramentas para uma janela proprietária que não é CFrameWnd, você precisar manipular as mensagens de TTN_NEEDTEXT na janela do proprietário da barra de ferramentas como descrito em Notificações de dica de ferramenta de manipulação. Se a janela pai da barra de ferramentas é derivada de CFrameWnd, dicas de ferramenta são exibidas sem nenhum esforço extra de como você CFrameWnd fornece um manipulador padrão.
Se você desejar que o usuário poderá personalizar a barra de ferramentas, manipular notificações de personalização na janela do proprietário como descrito em Notificações de manipulação de personalização.

Você pode usar SaveState para salvar o estado atual de um controle de barra de ferramentas para o Registro e em RestoreState para restaurar o estado baseado nas informações armazenadas anteriormente no Registro. Além de salvar o estado da barra de ferramentas entre os usos de aplicativo, armazenamento de aplicativos normalmente o estado antes que o usuário começar a personalizar a barra de ferramentas caso que o usuário deseja posteriormente para restaurar a barra de ferramentas para seu estado original.

Suporte para a versão do Internet Explorer 4,0 e posterior

Para oferecer suporte à funcionalidade introduzida no Internet Explorer, a versão 4,0 e posterior, MFC fornece suporte a lista de imagem e estilos transparentes e lisos para controles de barra de ferramentas.

Uma barra de ferramentas transparente permite que o cliente na barra de ferramentas mostra completamente. Para criar uma barra de ferramentas transparente, use estilos de TBSTYLE_FLAT e de TBSTYLE_TRANSPARENT . As barras de ferramentas transparentes apresentam o rastreamento quente; isto é, quando o ponteiro do mouse se move sobre quente um botão na barra de ferramentas, a aparência do botão muda. As barras de ferramentas criadas com apenas o estilo de TBSTYLE_FLAT conterão os botões que não são transparentes.

Suporte a lista de imagem permite a um controle maior flexibilidade para o comportamento padrão, imagens, imagens e quentes desativado. Use GetImageList, GetHotImageList, e GetDisabledImageList com a barra de ferramentas transparente para manipular a imagem de acordo com seu estado:

Para obter mais informações sobre como usar CToolBarCtrl, consulte Controles e usando CToolBarCtrl.