CMFCToolBar::SetToolBarBtnText

Especifica as propriedades de um botão na barra de ferramentas.

void SetToolBarBtnText(
   UINT nBtnIndex,
   LPCTSTR szText=NULL,
   BOOL bShowText=TRUE,
   BOOL bShowImage=TRUE 
);

Parâmetros

  • [in] nBtnIndex
    O índice baseado em zero do botão de barra de ferramentas na lista de botões da barra de ferramentas.

  • [in] szText
    Especifica o rótulo de texto do botão de barra de ferramentas.

  • [in] bShowText
    Se esse parâmetro for TRUE, a estrutura mostra o rótulo de texto. Caso contrário, a estrutura oculta o rótulo de texto.

  • [in] bShowImage
    Se esse parâmetro for TRUE, a estrutura mostra a imagem de botão de barra de ferramentas. Caso contrário, a estrutura oculta a imagem de botão de barra de ferramentas.

Comentários

Por padrão, a estrutura mostra as imagens dos botões da barra de ferramentas mas não mostra o rótulo de texto dos botões da barra de ferramentas.

Em compilações de depurar, este método gerará um erro de declaração se nBtnIndex não se refere a uma barra de ferramentas válida ou botão de barra de ferramentas estiver um separador.

Requisitos

Cabeçalho: afxtoolbar.h

Consulte também

Conceitos

Gráfico de hierarquia do MFC

Referência

Classe CMFCToolBar